QueueUserWorkItem 関数 (threadpoollegacyapiset.h)

スレッド プール内のワーカー スレッドに作業項目をキューに入 れます。

構文

BOOL QueueUserWorkItem(
  [in]           LPTHREAD_START_ROUTINE Function,
  [in, optional] PVOID                  Context,
  [in]           ULONG                  Flags
);

パラメーター

[in] Function

スレッド プール内のスレッドによって実行される LPTHREAD_START_ROUTINE 型のアプリケーション定義コールバック関数へのポインター。 この値は、スレッドの開始アドレスを表します。 このコールバック関数は 、TerminateThread 関数を呼び出してはなりません。

コールバック関数の戻り値は使用されません。

詳細については、「 ThreadProc」を参照してください。

[in, optional] Context

スレッド関数に渡される 1 つのパラメーター値。

[in] Flags

実行を制御するフラグ。 このパラメーターには、次の 1 つ以上の値を指定できます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

DLL 内の関数がワーカー スレッドにキューに登録されている場合は、DLL がアンロードされる前に関数の実行が完了していることを確認してください。

既定では、スレッド プールにはプロセスあたり最大 512 個のスレッドがあります。 キューの制限を引き上げるには、WinNT.h で定義 されているWT_SET_MAX_THREADPOOL_THREAD マクロを使用します。

#define WT_SET_MAX_THREADPOOL_THREADS(Flags,Limit) \
    ((Flags)|=(Limit)<<16)

QueueUserWorkItem の呼び出しでこのマクロを使用して、Flags パラメーターを指定します。 マクロ パラメーターは、必要なフラグと新しい制限 (最大 (2<<16)-1 スレッド) です。 ただし、キューのサイズは、カーネル非ページ プールのサイズによって制限されます。 アプリケーションでは、ワーカー スレッドの数を少なくすることで、パフォーマンスを向上させることができます。

この関数を使用するアプリケーションをコンパイルするには、 _WIN32_WINNT を 0x0500 以降として定義します。 詳細については、「 Windows ヘッダーの使用」を参照してください。

要件

関連項目

プロセス関数とスレッド関数

スレッド プール

ThreadProc