DIDEVICEIMAGEINFOHEADER

デバイス イメージに関する情報を格納します。IDirectInputDevice8::GetImageInfo メソッドで使用されます。

typedef struct DIDEVICEIMAGEINFOHEADER {
    DWORD dwSize;
    DWORD dwSizeImageInfo;
    DWORD dwcViews;
    DWORD dwcButtons;
    DWORD dwcAxes;
    DWORD dwcPOVs;
    DWORD dwBufferSize;
    DWORD dwBufferUsed;
    DIDEVICEIMAGEINFO * lprgImageInfoArray;
} DIDEVICEIMAGEINFOHEADER, *LPDIDEVICEIMAGEINFOHEADER;

メンバ

• dwSize
  この構造体のサイズ (バイト) を指定する DWORD 値。構造体を使用する前に、この値を初期化する必要があります。
• dwSizeImageInfo
  DIDEVICEIMAGEINFO 構造体のサイズ (バイト) を指定する DWORD 値。この構造体を使用する前に、この値を初期化する必要があります。
• dwcViews
  このデバイスのビューの数を受け取る DWORD 変数。
• dwcButtons
  このデバイスのボタンの数を受け取る DWORD 変数。
• dwcAxes
  このデバイスの軸の数を受け取る DWORD 変数。
• dwcPOVs
  このデバイスの視点コントローラーの数を受け取る DWORD 変数。
• dwBufferSize
  lprgImageInfoArray で指定されるバッファーのサイズ (バイト) を指定する DWORD 値。ゼロに設定すると、IDirectInputDevice8::GetImageInfo メソッドは他のすべてのメンバーを無視し、すべてのイメージの情報を保管するために必要な最小バッファー サイズを返します。
• dwBufferUsed
  lprgImageInfoArray で指定されるバッファー内で使用されているメモリーのサイズ (バイト) を受け取る DWORD 値。dwBufferSize がゼロに設定されると、IDirectInputDevice8::GetImageInfo メソッドは、すべてのイメージの情報を保管するために必要な最小サイズにこのメンバーを設定します。
• lprgImageInfoArray
  すべてのデバイス イメージとビュー、オーバーレイ イメージ、およびコールアウト文字列の座標を示す、DIDEVICEIMAGEINFO 構造体の配列を受け取るバッファーへのポインター。

解説　

lprgImageInfoArray で指定されるバッファーは、必要なイメージ情報構造体をすべて保管するために十分な大きさが必要です。dwBufferSize メンバーをゼロに設定して IDirectInputDevice8::GetImageInfo メソッドを呼び出すことによって、アプリケーションは必要なサイズを問い合わせることができます。 ◆前の文節に含まれる◇呼び出し後、変更されたメモリーの量 (バイト) が dwBufferUsed に格納されます。