IDirectInputDevice8::GetCapabilities メソッド
IDirectInputDevice8::GetCapabilities メソッド
DirectInputDevice オブジェクトの能力を取得する。
構文
HRESULT GetCapabilities(
LPDIDEVCAPS lpDIDevCaps
);
パラメータ
- lpDIDevCaps
デバイスの能力を格納する DIDEVCAPS 構造体のアドレス。この構造体の dwSize メンバは、このメソッドを呼び出す前に初期化しておかなければならない。
戻り値
成功した場合は、DI_OK を返す。
失敗した場合は、エラー値 DIERR_ACQUIRED または DIERR_INVALIDPARAM を返す。
DIERR_INVALIDPARAM | 無効なパラメータが、戻ってくる関数に渡されたか、オブジェクトがその関数を呼び出せる状態になかった。この値は、標準のコンポーネント オブジェクト モデル (COM) 戻り値である E_INVALIDARG に等しい。 |
DIERR_NOTINITIALIZED | このオブジェクトは初期化されていない。 |
E_POINTER | 無効なポインタ (通常は NULL) がパラメータとして渡された。 |
注意
Microsoft® DirectX® 3 との互換性が必要な場合は、sizeof(DIDEVCAPS_DX3) に初期化した dwSize メンバを含む DIDEVCAPS_DX3 構造体を渡してもよい。
DIDEVCAPS 構造体に返るオブジェクト数は、列挙できる最大オブジェクト数である。しかし、これらのすべてのオブジェクトが、IDirectInputDevice8::EnumObjects の呼び出し中に返るわけではない。