Platform SDK: DirectX

IDirectPlay4::GetCaps

IDirectPlay4::GetCaps メソッドは、該当する DirectPlay オブジェクトの能力を取得する。

HRESULT GetCaps(
  LPDPCAPS lpDPCaps,
  DWORD dwFlags
);

パラメータ

lpDPCaps
DirectPlay オブジェクトの能力を受け取る DPCAPS 構造体へのポインタ。IDirectPlay4::GetCaps を使用する前に DPCAPS 構造体の dwSize メンバを設定する必要がある。
dwFlags
このパラメータに 0 を設定した場合、保証なしのメッセージ処理に対する能力が計算される。
DPGETCAPS_GUARANTEED
保証付きのメッセージ配信の能力を取得する。

戻り値

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

DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS

注意

IDirectPlay4::GetPlayerCaps メソッドが要求されたプレーヤーの能力を返すのに対して、このメソッドはカレント セッションの能力を返す。

ただし、セッションが開いている間は、SendEx でサポートされているオプションを示す能力を使用できない。セッションのホストであるアプリケーションが DPSESSIONDESC2 構造体で DPSESSION_DIRECTPLAYPROTOCOL フラグを指定している場合は、すべての SendEx オプションがサポートされる。

必要条件

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

参照

DPCAPSIDirectPlay4::GetPlayerCapsIDirectPlay4::Send