Platform SDK: DirectX

IDirectPlay4::GetPlayerData

メソッドは、IDirectPlay4::SetPlayerData を使用してプレーヤー ID に関連付けられたアプリケーション固有のデータ ブロックを取得する。

HRESULT GetPlayerData(
  DPID idPlayer,
  LPVOID lpData,
  LPDWORD lpdwDataSize,
  DWORD dwFlags
);

パラメータ

idPlayer
データを要求するプレーヤー ID。
lpData
アプリケーション固有のプレーヤー データを書き込むバッファへのポインタ。データのサイズのみを要求するときは、このパラメータに NULL を設定する。lpdwDataSize パラメータはデータを保持するのに必要なサイズに設定される。
lpdwDataSize
このメソッドを呼び出す前に、バッファのサイズに初期化された変数へのポインタ。メソッドが戻ると、このパラメータにはプレーヤー データのサイズがバイト単位で設定されている。バッファが小さすぎる場合 (DPERR_BUFFERTOOSMALL)、このパラメータには必要なバッファのサイズが設定される。
dwFlags
このパラメータに 0 を設定した場合、リモート データが取得される。
DPGET_LOCAL
アプリケーションにより設定されたローカル データを取得する。
DPGET_REMOTE
リモートの共有データ領域からカレント データを取得する。

戻り値

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

DPERR_BUFFERTOOSMALL
DPERR_INVALIDFLAGS
DPERR_INVALIDOBJECT
DPERR_INVALIDPLAYER

注意

DirectPlay では、ローカルとリモートの両方のプレーヤー データを保守できる。アプリケーションは、検索するデータのタイプを指定する必要がある。ローカル データは、この DirectPlay オブジェクトにより DPSET_LOCAL フラグを使用して設定されている。リモート データは、セッション内の任意のアプリケーションにより DPSET_REMOTE フラグを使用して設定されている可能性がある。

必要条件

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dplay.h で宣言。
  インポート ライブラリ : dplayx.lib を使用。

参照

IDirectPlay4::SetPlayerData