IDirectInputDevice8::GetObjectInfo
ボタンや軸など、デバイス オブジェクトに関する情報を取得します。
HRESULT
GetObjectInfo(
LPDIDEVICEOBJECTINSTANCE pdidoi,
DWORD dwObj,
DWORD dwHow
);
パラメータ
- pdidoi
オブジェクトに関する情報を格納する DIDEVICEOBJECTINSTANCE 構造体のアドレス。このメソッドを呼び出す前に、この構造体の dwSize メンバーを初期化する必要があります。 - dwObj
情報を取得する対象のオブジェクトを示す値。このパラメーターに設定する値は、dwHow パラメーターに指定されている値によって異なります。 - dwHow
dwObj パラメーターを解釈する方法を指定する値。dwHow の値は次のいずれかです。- DIPH_BYOFFSET
dwObj パラメーターは、アクセスする情報を含むオブジェクトの現在のデータ フォーマットを取り出すためのオフセットです。 - DIPH_BYID
dwObj パラメーターは、オブジェクト タイプ/インスタンス識別子です。この識別子が返される場所は、前に呼び出された IDirectInputDevice8::EnumObjects メソッドから返された DIDEVICEOBJECTINSTANCE 構造体の dwType メンバー内です。 - DIPH_BYUSAGE
dwObj パラメーターの内容は、オブジェクトの HID 使用ページと使用値を DIMAKEUSAGEDWORD マクロによって結合したものです。
- DIPH_BYOFFSET
戻り値
メソッドが正常に実行された場合、戻り値は DI_OK です。メソッドが失敗した場合、戻り値は次のいずれかのエラー値です。DIERR_INVALIDPARAM、DIERR_NOTINITIALIZED、DIERR_OBJECTNOTFOUND、E_POINTER
解説
DirectX 3 との互換性のために、 DIDEVICEOBJECTINSTANCE_DX3 構造体を渡し、 dwSize メンバーを sizeof(DIDEVICEOBJECTINSTANCE_DX3) に初期化する操作も有効です。
要件
ヘッダー: Dinput.h 宣言