DD_GETD3DQUERYDATA 構造体 (d3dhal.h)

[アーティクル]
02/26/2024

DirectX 9.0 以降のバージョンのみ。

DD_GETD3DQUERYDATAは、型がD3DGDI2_TYPE_GETD3DQUERYのDD_GETDRIVERINFO2DATAクエリのDD_GETDRIVERINFODATAの lpvData フィールドが指すデータ構造です。

構文

typedef struct _DD_GETD3DQUERYDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  union {
    DWORD        dwQueryIndex;
    D3DQUERYTYPE QueryType;
  };
} DD_GETD3DQUERYDATA;

メンバー

gdi2

GetDriverInfo2 データを含むDD_GETDRIVERINFO2DATA構造体を指定します。

dwQueryIndex

返すクエリの種類のインデックスを指定します。

QueryType

実際のクエリ機能を指定する値をD3DQUERYTYPE列挙から受け取ります。

注釈

ランタイムは、返されるクエリの種類を、値が 0 から 1 未満の間で変化する整数インデックスで識別します。これは、D3DGDI2_TYPE_GETD3DQUERYCOUNT クエリでドライバーによって以前に報告されたサポートされているクエリの種類の数より少なくなります。これらのインデックスを実際のクエリの種類にマップする方法は、ドライバーに任されています。ただし、各インデックスは、サポートされている 1 つのクエリの種類に一意にマップする必要があります。クエリの種類が報告される順序は重要ではありません。

この GetDriverInfo2 要求を処理する場合、ドライバーは共用体の値を dwQueryIndex メンバーであるかのように読み取り、その値をサポートされているクエリ型のいずれかにマップする必要があります (おそらく 、dwQueryIndex の値をインデックスとしてD3DQUERYTYPE値の配列に使用します)。その後、ドライバーはそのクエリの種類を 、QueryType メンバーであるかのように共用体にコピーする必要があります。ランタイムは、インデックスを 0 からドライバーによって報告されたクエリの種類の数より 1 つ小さい範囲のドライバーにのみ渡すように保証します。インデックスの範囲は、デバッグドライバービルドで検証する必要があります。

D3DQUERYTYPEの詳細については、DirectX SDK のドキュメントを参照してください。