<Return[S]><Top>

SetThreadPriority

Declare Function Api_SetThreadPriority& Lib "kernel32" Alias "SetThreadPriority" (ByVal hThread&, ByVal nPriority&)

Declare Function SetThreadPriority Lib "kernel32" Alias "SetThreadPriority" (ByVal hThread As Long, ByVal nPriority As Long) As Long

パラメータ
hThread
    相対優先順位値を設定するべきスレッドのハンドルを指定する。
    Windows NT/2000:このハンドルに、THREAD_SET_INFORMATION アクセス権を割り当てておかなければならない。
nPriority
    スレッドの相対優先順位値を指定する。次の値のいずれかを指定する。

    相対優先順位値                                       

意味                                                                                                            

    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 を指定す

る。

    Windows 2000:このパラメータで、-7、-6、-5、-4、-3、3、4、5、6 のいずれかを指定することもできる。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。