Platform SDK: DirectX

IDirectInputDevice7::SetDataFormat

IDirectInputDevice7::SetDataFormat メソッドは、DirectInput デバイスのデータ形式を設定する。

HRESULT SetDataFormat(
  LPCDIDATAFORMAT lpdf  
);

パラメータ

lpdf
DirectInputDevice が返すべきデータ形式を記述する構造体のアドレス。アプリケーションは、独自の DIDATAFORMAT 構造体を定義することも、次の事前定義されたグローバル変数の 1 つを使用することもできる。

戻り値

成功すれば DI_OK を返す。

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

DIERR_ACQUIRED
DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED

注意

IDirectInputDevice7::Acquire でデバイスを取得する前に、データ形式を設定しておかなければならない。データ形式は、一度設定するだけでよい。データ形式は、デバイスが取得されている間は変更できない。

動作環境

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

参照

IDirectInputDevice7::GetDeviceState