Win32 API 日本語リファレンス
ホーム › System.ComponentServices › IThreadPoolKnobs

IThreadPoolKnobs

COM
📘 Microsoft Learn (日本語) · English
IID51372af7-cae7-11cf-be81-00aa00a2fa25継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

スレッドプールの動作を制御するために使用します。

メソッド 10

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetMaxThreads(INT* plcMaxThreads)

プール内で許可されるスレッドの最大数を取得します。

plcMaxThreadsINT*inoutプール内で許可されるスレッドの最大数。値が 0 の場合、プールは制限なく拡張できることを示します。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 4 HRESULT GetCurrentThreads(INT* plcCurrentThreads)

現在プール内にあるスレッドの数を取得します。

plcCurrentThreadsINT*inout現在プール内にあるスレッドの数。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 5 HRESULT SetMaxThreads(INT lcMaxThreads)

プール内で許可するスレッドの最大数を設定します。

lcMaxThreadsINTinプール内で許可されるスレッドの最大数。値が 0 の場合、プールは制限なく拡張できることを示します。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 6 HRESULT GetDeleteDelay(INT* pmsecDeleteDelay)

プール内のスレッドが破棄されるまでにアイドル状態でいられるミリ秒数を取得します。

pmsecDeleteDelayINT*inoutプール内のスレッドが破棄されるまでにアイドル状態でいられるミリ秒数。値が 0 の場合、スレッドが自動的に削除されることはありません。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 7 HRESULT SetDeleteDelay(INT msecDeleteDelay)

プール内のスレッドが破棄されるまでにアイドル状態でいられるミリ秒数を設定します。

msecDeleteDelayINTinプール内のスレッドが破棄されるまでにアイドル状態でいられるミリ秒数。値が 0 の場合、スレッドが自動的に削除されることはありません。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 8 HRESULT GetMaxQueuedRequests(INT* plcMaxQueuedRequests)

同時にキューに入れることができる非同期実行要求の最大数を取得します。

plcMaxQueuedRequestsINT*inout同時にキューに入れることができる非同期実行要求の最大数。値が 0 の場合、キューは制限なく拡張できることを示します。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 9 HRESULT GetCurrentQueuedRequests(INT* plcCurrentQueuedRequests)

現在キューに入っている非同期実行要求の数を取得します。

plcCurrentQueuedRequestsINT*inout現在キューに入っている非同期実行要求の数。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 10 HRESULT SetMaxQueuedRequests(INT lcMaxQueuedRequests)

同時にキューに入れることができる非同期実行要求の最大数を設定します。

lcMaxQueuedRequestsINTin同時にキューに入れることができる非同期実行要求の最大数。値が 0 の場合、キューは制限なく拡張できることを示します。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 11 HRESULT SetMinThreads(INT lcMinThreads)

プール内で維持するスレッドの最小数を設定します。

lcMinThreadsINTinプール内で維持するスレッドの最小数。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

vtbl 12 HRESULT SetQueueDepth(INT lcQueueDepth)

この数を超えると新しいスレッドがプールに追加される、実行要求のしきい値を設定します。

lcQueueDepthINTinこの数を超えると新しいスレッドがプールに追加される、実行要求のしきい値。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IThreadPoolKnobs "{51372AF7-CAE7-11CF-BE81-00AA00A2FA25}"
#usecom global IThreadPoolKnobs IID_IThreadPoolKnobs "{}"
#comfunc global IThreadPoolKnobs_GetMaxThreads             3 var
#comfunc global IThreadPoolKnobs_GetCurrentThreads         4 var
#comfunc global IThreadPoolKnobs_SetMaxThreads             5 int
#comfunc global IThreadPoolKnobs_GetDeleteDelay            6 var
#comfunc global IThreadPoolKnobs_SetDeleteDelay            7 int
#comfunc global IThreadPoolKnobs_GetMaxQueuedRequests      8 var
#comfunc global IThreadPoolKnobs_GetCurrentQueuedRequests  9 var
#comfunc global IThreadPoolKnobs_SetMaxQueuedRequests      10 int
#comfunc global IThreadPoolKnobs_SetMinThreads             11 int
#comfunc global IThreadPoolKnobs_SetQueueDepth             12 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。