RtkGetProxyThreadPriority

RtkGetProxyThreadPriority gets the priority value of the proxy thread associated with the driver-created kernel thread.

Syntax

NTSTATUS RtkGetProxyThreadPriority(
    RTSSINST RtssInst,
    HANDLE hThread,
    int * RtssPriority
);

Parameters

RtssInst

An RTSSINST value. Must pass in a valid RTSSINST value or the call will fail with STATUS_INVALID_PARAMETER.

hThread

The handle which identifies the kernel thread as returned by a preceding call to the Windows kernel driver support routine PsGetCurrentThreadId().

RtssPriority

A priority level from 0 to 127, where 127 identifies the highest priority proxy thread.

Return Value

RtkGetProxyThreadPriority returns STATUS_SUCCESS on success or on failure. One of the following NTSTATUS error codes is possible:

• STATUS_INVALID_HANDLE
• STATUS_UNSUCCESSFUL

Remarks

For every driver-created kernel thread making RtkAPI call, a corresponding proxy thread shall be created. Calling RtkGetProxyThreadPriorty retrives the priority of proxy thread associated with hThread handle value. This API does not retrieve the priority of driver-created kernel thread.

See Also:

RtkSetProxyThreadPriority