DD_GETFORMATDATA 구조체(d3dhal.h)

  • 아티클

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

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

구문

typedef struct _DD_GETFORMATDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwFormatIndex;
  DDPIXELFORMAT         format;
} DD_GETFORMATDATA;

멤버

gdi2

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

dwFormatIndex

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

format

DDPIXELFORMAT 구조체에서 실제 픽셀 형식을 받습니다.

설명

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

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

DirectX 9.0 이상 버전만 해당합니다.입력 시 애플리케이션에서 사용되는 DirectX 런타임의 버전은 DDPIXELFORMAT 구조체의 dwSize멤버 형식으로 지정됩니다. 이 dwSize 멤버는 directX 9.0에 대해 0x00000900 DD_RUNTIME_VERSION 설정됩니다.

요구 사항

요구 사항 값
헤더 d3dhal.h(D3dhal.h 포함)

추가 정보

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA