D3DADAPTER_IDENTIFIER9 구조체

  • 아티클

어댑터를 식별하는 정보를 포함합니다.

구문

typedef struct D3DADAPTER_IDENTIFIER9 {
  char          Driver[MAX_DEVICE_IDENTIFIER_STRING];
  char          Description[MAX_DEVICE_IDENTIFIER_STRING];
  char          DeviceName[32];
#ifdef _WIN32
  LARGE_INTEGER DriverVersion;
#else
  DWORD         DriverVersionLowPart;
  DWORD         DriverVersionHighPart;
#endif
  DWORD         VendorId;
  DWORD         DeviceId;
  DWORD         SubSysId;
  DWORD         Revision;
  GUID          DeviceIdentifier;
  DWORD         WHQLLevel;
} D3DADAPTER_IDENTIFIER9, *LPD3DADAPTER_IDENTIFIER9;

멤버

Driver

형식: char

사용자에게 프레젠테이션에 사용됩니다. 여러 문자열이 서로 다른 공급업체의 동일한 디바이스 및 드라이버와 연결될 수 있으므로 특정 드라이버를 식별하는 데 사용하면 안 됩니다.

설명

형식: char

사용자에게 프레젠테이션에 사용됩니다.

Devicename

형식: char

GDI의 디바이스 이름입니다.

DriverVersion

형식: LARGE_INTEGER

Direct3D 드라이버의 버전을 식별합니다. 서명된 64비트 정수 값에 대한 비교보다 작거나 더 큰 작업을 수행하는 것이 합법적입니다. 그러나 이 요소를 사용하여 문제가 있는 드라이버를 식별하는 경우 주의해야 합니다. 대신 DeviceIdentifier를 사용해야 합니다. 설명 부분을 참조하세요.

DriverVersionLowPart

형식: DWORD

Direct3D 드라이버의 버전을 식별합니다. 64비트 부제 정수 값과 비교하는 것은 합법적 <> 입니다. 그러나 이 요소를 사용하여 문제가 있는 드라이버를 식별하는 경우 주의해야 합니다. 대신 DeviceIdentifier를 사용해야 합니다. 설명 부분을 참조하세요.

DriverVersionHighPart

형식: DWORD

Direct3D 드라이버의 버전을 식별합니다. 64비트 부제 정수 값과 비교하는 것은 합법적 <> 입니다. 그러나 이 요소를 사용하여 문제가 있는 드라이버를 식별하는 경우 주의해야 합니다. 대신 DeviceIdentifier를 사용해야 합니다. 설명 부분을 참조하세요.

VendorId

형식: DWORD

특정 칩 세트를 식별하는 데 사용할 수 있습니다. 이 멤버를 쿼리하여 제조업체를 식별합니다. 알 수 없는 경우 값은 0일 수 있습니다.

DeviceId

형식: DWORD

특정 칩 세트를 식별하는 데 사용할 수 있습니다. 이 멤버를 쿼리하여 칩 집합 유형을 식별합니다. 알 수 없는 경우 값은 0일 수 있습니다.

SubSysId

형식: DWORD

특정 칩 세트를 식별하는 데 사용할 수 있습니다. 이 멤버를 쿼리하여 하위 시스템(일반적으로 특정 보드)을 식별합니다. 알 수 없는 경우 값은 0일 수 있습니다.

수정 버전

형식: DWORD

특정 칩 세트를 식별하는 데 사용할 수 있습니다. 이 멤버를 쿼리하여 칩 집합의 수정 수준을 식별합니다. 알 수 없는 경우 값은 0일 수 있습니다.

DeviceIdentifier

형식: GUID

드라이버 및 칩 집합의 변경 내용을 검사 쿼리할 수 있습니다. 이 GUID는 드라이버 및 칩 집합 쌍에 대한 고유 식별자입니다. 그래픽 하위 시스템에 대한 새 프로필을 생성하기 위해 드라이버 및 칩 집합의 변경 내용을 추적하려면 이 멤버를 쿼리합니다. DeviceIdentifier를 사용하여 문제가 있는 특정 드라이버를 식별할 수도 있습니다.

WHQLLevel

형식: DWORD

이 드라이버 및 디바이스 쌍에 대한 WHQL(Windows Hardware Quality Labs) 유효성 검사 수준을 결정하는 데 사용됩니다. DWORD는 드라이버에서 통과한 가장 최근의 WHQL 테스트 릴리스 날짜를 정의하는 압축된 날짜 구조입니다. 이 값에 대해 및 > 작업을 수행하는 < 것은 합법적입니다. 다음은 날짜 형식을 보여 줍니다.

비트 Description
31-16 올해는 1999년의 10진수 이상입니다.
15-8 1에서 12까지의 10진수인 월입니다.
7-0 일, 1에서 31까지의 10진수입니다.

 

다음 값도 사용됩니다.

값 Description
0 인증되지 않았습니다.
1 WHQL의 유효성이 검사되었지만 날짜 정보를 사용할 수 없습니다.

 

Direct3D 9와 Direct3D 9Ex 간의 차이점:

Windows Vista, Windows Server 2008, Windows 7 및 Windows Server 2008 R2(또는 현재 운영 체제 이상)에서 실행되는 Direct3D9Ex의 경우 IDirect3D9::GetAdapterIdentifier는 드라이버의 상태 확인하지 않고 WHQL 수준에 대해 1을 반환합니다.

설명

다음 의사 코드 예제에서는 DriverVersion, DriverVersionLowPart 및 DriverVersionHighPart 멤버에 인코딩된 버전 형식을 보여 줍니다.

Product = HIWORD(DriverVersion.HighPart)
Version = LOWORD(DriverVersion.HighPart)
SubVersion = HIWORD(DriverVersion.LowPart)
Build = LOWORD(DriverVersion.LowPart)

HIWORD 매크로, LOWORD 매크로 및 LARGE_INTEGER 구조에 대한 자세한 내용은 플랫폼 SDK를 참조하세요.

MAX_DEVICE_IDENTIFIER_STRING 다음 정의가 포함된 상수입니다.

#define MAX_DEVICE_IDENTIFIER_STRING        512

VendorId, DeviceId, SubSysId 및 Revision 멤버를 함께 사용하여 특정 칩 집합을 식별할 수 있습니다. 그러나 이러한 멤버는 주의해서 사용합니다.

요구 사항

요구 사항 값
헤더
D3D9Types.h

추가 정보

Direct3D 구조체