次の方法で共有


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 を呼び出すことでデータ形式が設定される。

参照

IDirectInputDevice8::GetDeviceState