<Return[G]><Top>

GetThreadPriority

Declare Function Api_GetThreadPriority& Lib "kernel32" Alias "GetThreadPriority" (ByVal hThread&)

Declare Function GetThreadPriority Lib "kernel32" Alias "GetThreadPriority" (ByVal hThread As Long) As Long

指定されたスレッドの相対優先順位値を取得する。プロセスの優先順位クラスと、スレッドの相対優先順位値によって、各スレッドの基本優先順位レベルが決まる。

パラメータ
hThread
    スレッドのハンドルを指定する。
    Windows NT/2000：このハンドルに、THREAD_QUERY_INFORMATION アクセス権を割り当てておかなければならない。

戻り値
    関数が成功すると、指定したスレッドの相対優先順位値が返る。
    関数が失敗すると、THREAD_PRIORITY_ERROR_RETURN が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。
    スレッドの相対優先順位値は、次の値のいずれかになる。

     相対優先順位値                                        

意味                                                                                                             

    THREAD_PRIORITY_ABOVE_NORMAL

スレッド標準の相対優先順位値より 1 ポイント高い相対優先順位値。

    THREAD_PRIORITY_BELOW_NORMAL

スレッド標準の相対優先順位値より 1 ポイント低い相対優先順位値。

    THREAD_PRIORITY_HIGHEST

スレッド標準の相対優先順位値より 2 ポイント高い相対優先順位値。

    THREAD_PRIORITY_IDLE

　

　

　

　

プロセスの優先順位クラスが IDLE_PRIORITY_CLASS、

BELOW_NORMAL_PRIORITY_CLASS、

NORMAL_PRIORITY_CLASS、

ABOVE_NORMAL_PRIORITY_CLASS、

HIGH_PRIORITY_CLASS のいずれかである場合は、基本優先順位レベルが 1 である

ことを示す。プロセスの優先順位クラスが REALTIME_PRIORITY_CLASS である場合は、基本優先順位レベルが 16 であることを示す。

    THREAD_PRIORITY_LOWEST

スレッド標準の相対優先順位値より 2 ポイント低い相対優先順位値。

    THREAD_PRIORITY_NORMAL

スレッド標準の相対優先順位値。

    THREAD_PRIORITY_TIME_CRITICAL

　

　

　

　

プロセスの優先順位クラスが IDLE_PRIORITY_CLASS、BELOW_NORMAL_PRIORITY_CLASS、NORMAL_PRIORITY_CLASS、ABOVE_NORMAL_PRIORITY_CLASS、HIGH_PRIORITY_CLASS のいずれかである

場合は、基本優先順位レベルが 15 であることを示す。プロセスの優先順位クラスが

REALTIME_PRIORITY_CLASS である場合は、基本優先順位レベルが 31 であることを示す。


解説
    各スレッドの基本優先順位レベルは、所属プロセスの優先順位クラスと、そのスレッドの相対優先順位値によって決まる。