Microsoft DirectX 8.0 (C++)

IDirectInputDevice8::SetDataFormat

Microsoft® DirectInput® デバイスのデータ形式を設定する。

HRESULT SetDataFormat(
  LPCDIDATAFORMAT lpdf  
);

パラメータ

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

戻り値

成功した場合は、DI_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DIERR_ACQUIRED
DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED

注意

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

アプリケーションがアクション マップを使用している場合は、代わりに IDirectInputDevice8::SetActionMap を呼び出すことでデータ形式が設定される。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : dinput.h で宣言。

参照

IDirectInputDevice8::GetDeviceState