DICONFIGUREDEVICESPARAMS
デバイス構成プロパティ シートに関する情報を格納する。IDirectInput8::ConfigureDevices メソッドで使用される。
typedef struct _DICONFIGUREDEVICESPARAMS {
DWORD dwSize;
DWORD dwcUsers;
LPSTR lptszUserNames;
DWORD dwcFormats;
LPDIACTIONFORMAT lprgFormats;
HWND hwnd;
DICOLORSET dics;
IUnknown FAR * lpUnkDDSTarget;
} DICONFIGUREDEVICESPARAMS, *LPDICONFIGUREDEVICESPARAMS;
メンバ
- dwSize
- この構造体のバイト単位のサイズ。
- dwcUsers
- lptszUserNames が指すバッファに含まれるユーザー名の数。lptszUserNames が NULL である場合 (デフォルト ユーザー名が使用されることを示す)、このメンバの値は無視される。dwcUsers の値が、実際にバッファ内にあるエントリの数より大きい場合、メソッドは失敗し、DIERR_INVALIDPARAM を返す。
- lptszUserNames
- 一連の NULL 終端名前文字列を格納するバッファへのポインタ。二重 NULL ターミネータによって指定される最後の要素である。lptszUserNames パラメータを NULL に設定し、デフォルト名の使用を指定することができる。アプリケーションが指定数以上の名前を渡す場合、指定数内の名前だけが使用される。アプリケーションが現在デバイスに割り当てられた名前とは異なる名前を指定する場合、すべてのデバイスで所有権が取り消され、一致しない名前用にデフォルト名が作成され、すべてのデバイスでインターフェイスに "(No User)" が表示される。
- dwcFormats
- lprgFormats が指す配列内の構造体の数。
- lprgFormats
- ゲームで使用される各ジャンルのアクション マッピング情報を格納する DIACTIONFORMAT 構造体の配列へのポインタ。入力時、この配列にはアクションとコントロールのマッピング、および各マッピングのコールアウトとして表示する文字列が格納される。構成インターフェイスでは、ドロップダウン リストに配列内と同じ順序でジャンルが表示される。
- hwnd
- 呼び出し元アプリケーションの最上位ウィンドウへのハンドル。このメンバが必要なのは、アプリケーションがウィンドウ表示モードで稼働している場合のみであり、それ以外は無視される。
- dics
- 構成ユーザー インターフェイスに適用する配色を表す DICOLORSET 構造体。ゼロで初期化された DICOLORSET 構造体を渡すと、デフォルトの配色が使用される。
- lpUnkDDSTarget
- 構成ユーザー インターフェイスのイメージが格納される Microsoft® DirectDraw® または Microsoft Direct3D® ターゲット サーフェス オブジェクトの IUnknown インターフェイスへのポインタ。このイメージは、DIEnumDevicesBySemanticsCallback 関数が呼び出された時点におけるユーザー インターフェイスの現在の状態を表す。ターゲット サーフェスは、前の DICOLORSET 構造体の一部として渡されたアルファ情報と、ハードウェア メーカーによってデバイス イメージにエンコードされたアルファ情報を保持する。IUnknown インターフェイスが参照するターゲット サーフェス オブジェクトは、IDirect3DSurface8 または IDirectDrawSurface7 をサポートする必要がある。DirectDraw を使用するフルスクリーン アプリケーションは、DDSCAPS_SYSTEMEMORY フラグを使って作成されたターゲット サーフェスを持つ必要がある。
DirectDraw を使用しないアプリケーションと、DirectDraw を使用するが、全画面を使用するのではなくウィンドウ化して実行されるアプリケーションは、このパラメータに NULL を渡すことができる。その場合、Microsoft DirectInput® は Windows GDI (Graphics Device Interface) 関数を使用して構成ユーザー インターフェイス イメージを描画する。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : dinput.h で宣言。