DD_GETD3DQUERYDATA 구조체(d3dhal.h)

아티클
02/23/2024

DirectX 9.0 이상 버전만 해당합니다.

DD_GETD3DQUERYDATA 형식이 D3DGDI2_TYPE_GETD3DQUERY DD_GETDRIVERINFO2DATA 쿼리에 대한 DD_GETDRIVERINFODATAlpvData 필드가 가리키는 데이터 구조입니다.

구문

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

멤버

gdi2

GetDriverInfo2 데이터를 포함하는 DD_GETDRIVERINFO2DATA 구조를 지정합니다.

dwQueryIndex

반환할 쿼리 형식의 인덱스를 지정합니다.

QueryType

실제 쿼리 기능을 지정하는 D3DQUERYTYPE 열거형에서 값을 받습니다.

설명

런타임은 값이 D3DGDI2_TYPE_GETD3DQUERYCOUNT 쿼리에서 드라이버가 이전에 보고한 지원되는 쿼리 형식 수보다 0과 1보다 작은 정수 인덱스로 반환할 쿼리 형식을 식별합니다. 이러한 인덱스를 실제 쿼리 형식에 매핑하는 방법은 드라이버에 남아 있습니다. 그러나 각 인덱스가 지원되는 하나의 쿼리 형식에 고유하게 매핑되어야 합니다. 쿼리 형식이 보고되는 순서는 중요하지 않습니다.

이 GetDriverInfo2 요청을 처리할 때 드라이버는 dwQueryIndex 멤버인 것처럼 공용 구조체의 값을 읽고 해당 값을 지원되는 쿼리 형식 중 하나에 매핑해야 합니다(아마도 dwQueryIndex 의 값을 D3DQUERYTYPE 값 배열로 인덱스로 사용). 그런 다음 드라이버는 QueryType 멤버인 것처럼 해당 쿼리 형식을 공용 구조체에 복사해야 합니다. 런타임은 범위가 0인 드라이버에만 인덱스를 전달하여 드라이버에서 보고한 쿼리 형식 수보다 1개만 전달하도록 보장합니다. 인덱스 범위는 디버그 드라이버 빌드에서 유효성을 검사해야 합니다.

D3DQUERYTYPE 대한 자세한 내용은 DirectX SDK 설명서를 참조하세요.