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 の呼び出し中に返るわけではない。