Microsoft DirectX 8.0 (C++)

IDirectPlay8Peer::Initialize

IDirectPlay8Peer インターフェイスおよびリモート ピアからのメッセージをすべて受信する、ピアのコード内のエントリ ポイントを登録する。このメソッドを呼び出してから、このインターフェイスのその他のメソッドを呼び出す必要がある。

HRESULT Initialize(
PVOID const pvUserContext,
const PFNDPNMESSAGEHANDLER pfn,
const DWORD dwFlags
);

パラメータ

pvUserContext
メッセージ ハンドラの呼び出しで指定される、ユーザー指定のコンテキスト値。ユーザー指定のコンテキスト値を使用すると、複数のインターフェイスから共通のメッセージ ハンドラに送信されたメッセージを区別できる。
pfn
PFNDPNMESSAGEHANDLER コールバック関数へのポインタ。リモート ピアからのすべてのメッセージおよび IDirectPlay8Peer インターフェイスからのセッション変更の通知を受け取るとき、この関数が使用される。
dwFlags
次のフラグを指定できる。
DPNINITIALIZE_DISABLEPARAMVAL
このフラグを渡すと、現在のオブジェクトに対するパラメータ妥当性の検証が無効になる。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_INVALIDFLAGS
DPNERR_INVALIDPARAM

注意

IDirectPlay8Peer インターフェイスを取得するには、CoCreateInstance を使用した後にこのメソッドを呼び出す。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplay8.h で宣言。