次の方法で共有


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 を返す。