次の方法で共有


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 マクロによって結合したものです。

戻り値

メソッドが正常に実行された場合、戻り値は DI_OK です。メソッドが失敗した場合、戻り値は次のいずれかのエラー値です。DIERR_INVALIDPARAM、DIERR_NOTINITIALIZED、DIERR_OBJECTNOTFOUND、E_POINTER

解説 

DirectX 3 との互換性のために、 DIDEVICEOBJECTINSTANCE_DX3 構造体を渡し、 dwSize メンバーを sizeof(DIDEVICEOBJECTINSTANCE_DX3) に初期化する操作も有効です。

要件

ヘッダー: Dinput.h 宣言