IDirectPlay8ThreadPool::Initialize メソッド
IDirectPlay8ThreadPool::Initialize メソッド
プロセスのスレッド プール インターフェイスを初期化する。
構文
HRESULT Initialize(
PVOID const pvUserContext,
const PFNDPNMESSAGEHANDLER pfn,
const DWORD dwFlags
);
パラメータ
- pvUserContext
[in] すべてのメッセージ コールバックのユーザー コンテキスト。 - pfn
[in] スレッド プール メッセージを処理する PFNDPNMESSAGEHANDLER 関数へのポインタ。 - dwFlags
[in] 次のフラグを指定できる。DPNINITIALIZE_DISABLEPARAMVAL
パラメータ妥当性の検証を無効にする。
戻り値
成功した場合は DPN_OK を返す。それ以外の場合、次のいずれかのエラーを返す。
DPNERR_ALREADYINITIALIZED | オブジェクトは既に初期化されている。 |
DPNERR_INVALIDFLAGS | このメソッドに渡されたフラグは無効である。 |
DPNERR_INVALIDPARAM | メソッドに渡された 1 つあるいは複数のパラメータが無効である。 |
DPNERR_NOTALLOWED | この機能は、このオブジェクトでは許可されていない。 |
注意
1 つのプロセスでは 1 つの IDirectPlay8ThreadPool オブジェクトしか利用できない。IDirectPlay8ThreadPool::Initialize を 2 番目の IDirectPlay8ThreadPool オブジェクトに対して呼び出すと、DPNERR_ALREADYINITALIZED が返される。
Microsoft® DirectPlay® オブジェクトが既にスレッドを作成している場合、IDirectPlay8ThreadPool オブジェクトは初期化できない。IDirectPlay8ThreadPool オブジェクトが初期化されていない場合、このメソッドは DPNERR_NOTALLOWED を返す。