IDirectInputDevice8::SetDataFormat メソッド
IDirectInputDevice8::SetDataFormat メソッド
Microsoft® DirectInput® デバイスのデータ形式を設定する。
構文
HRESULT SetDataFormat(
LPCDIDATAFORMAT lpdf
);
パラメータ
- lpdf
DirectInputDevice が返すデータ形式を記述する構造体のアドレス。アプリケーションは、独自の DIDATAFORMAT 構造体を定義することも、次の事前定義されたグローバル変数の 1 つを使うこともできる。- c_dfDIKeyboard
- c_dfDIMouse
- c_dfDIMouse2
- c_dfDIJoystick
- c_dfDIJoystick2
戻り値
成功した場合は、DI_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DIERR_ACQUIRED | 操作は、デバイスが取得状態の間は実行できない。 |
DIERR_INVALIDPARAM | 無効なパラメータが、戻ってくる関数に渡されたか、オブジェクトがその関数を呼び出せる状態になかった。この値は、標準のコンポーネント オブジェクト モデル (COM) 戻り値である E_INVALIDARG に等しい。 |
DIERR_NOTINITIALIZED | このオブジェクトは初期化されていない。 |
注意
IDirectInputDevice8::Acquire でデバイスを取得する前に、データ形式を設定しておかなければならない。データ形式は、一度設定するだけでよい。データ形式は、デバイスが取得されている間は変更できない。
アプリケーションがアクション マップを使っている場合は、代わりに IDirectInputDevice8::SetActionMap を呼び出すことでデータ形式が設定される。
参照