DD_GETFORMATDATA 構造体 (d3dhal.h)
DirectX 8.0 以降のバージョンのみ。
DD_GETFORMATDATAは、型がD3DGDI2_TYPE_GETFORMATのDD_GETDRIVERINFO2DATAクエリのDD_GETDRIVERINFODATAの lpvData フィールドが指すデータ構造です。
構文
typedef struct _DD_GETFORMATDATA {
DD_GETDRIVERINFO2DATA gdi2;
DWORD dwFormatIndex;
DDPIXELFORMAT format;
} DD_GETFORMATDATA;
メンバー
gdi2
GetDriverInfo2 データを含むDD_GETDRIVERINFO2DATA構造体を指定します。
dwFormatIndex
返すピクセル形式のインデックスを指定します。
format
DDPIXELFORMAT 構造体で実際のピクセル形式を受け取ります。
注釈
ランタイムは、返される形式を整数インデックスで識別します。その値は、ドライバーによって以前に報告されたサポートされている形式の数より 0 から 1 未満の間で変化します。 これらのインデックスを実際の形式にマップする方法は、ドライバーに任されています。 ただし、各インデックスは、サポートされている 1 つの形式に一意にマップする必要があります。 形式が報告される順序は重要ではありません。
この GetDriverInfo2 要求を処理する場合、ドライバーは dwFormatIndex を読み取り、サポートされている形式のいずれかにマップし (おそらく、DDPIXELFORMAT 構造体の配列に インデックスとして dwFormatIndex を使用)、その形式を DD_GETFORMATDATA フィールドの format フィールドにコピーする必要があります。 ランタイムでは、ドライバーによって報告されるサーフェス形式の数より 1 未満の範囲のドライバーにのみインデックスが渡されることを保証します。 インデックスの範囲は、デバッグ ドライバービルドで検証する必要があります。
DirectX 9.0 以降のバージョンのみ。入力時に、アプリケーションで使用されている DirectX ランタイムのバージョンは、DDPIXELFORMAT 構造体の dwSize メンバーで 形式で指定されます。 この dwSize メンバーは、DirectX 9.0 に0x00000900 DD_RUNTIME_VERSIONに設定されます。
要件
| 要件 | 値 |
|---|---|
| Header | d3dhal.h (D3dhal.h を含む) |