Platform SDK: DirectX

IDirectInputDevice7::GetObjectInfo

IDirectInputDevice7::GetObjectInfo メソッドは、ボタンや軸などのデバイス オブジェクトの情報を取得する。

HRESULT GetObjectInfo(
  LPDIDEVICEOBJECTINSTANCE pdidoi,  
  DWORD dwObj,                      
  DWORD dwHow                       
);

パラメータ

pdidoi
オブジェクトの情報を格納する DIDEVICEOBJECTINSTANCE 構造体のアドレス。この構造体の dwSize メンバは、このメソッドを呼び出す前に初期化しておかなければならない。
dwObj
取得する情報が所属するオブジェクトを識別する値。このパラメータに設定する値は、dwHow パラメータで指定されている値に依存する。
dwHow
dwObj パラメータの解釈方法を指定する値。この値は、次のいずれか 1 つである。
意味
DIPH_BYOFFSET dwObj パラメータは、アクセスする情報が所属するオブジェクトの現在のデータ形式に対するオフセットである。
DIPH_BYID dwObj パラメータは、オブジェクト タイプ、またはインスタンス識別子である。この識別子は、DIDEVICEOBJECTINSTANCE 構造体の dwType メンバの中に返される。この構造体は、IDirectInputDevice7::EnumObjects メソッドに対する以前の呼び出しで返されたものである。
DIPH_BYUSAGE dwObj パラメータは、オブジェクトの "HID 使用ページ" と "使用状況" の値である。これらの値は DIMAKEUSAGEDWORD マクロにより組み合わせられる。

戻り値

成功すれば DI_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED
DIERR_OBJECTNOTFOUND

注意

DirectX 3 との互換性については、sizeof(DIDEVICEOBJECTINSTANCE_DX3) に初期化した dwSize メンバを含む DIDEVICEOBJECTINSTANCE_DX3 構造体を渡してもよい。詳細については、「前のバージョンの DirectInput の設計」を参照すること。

動作環境

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