D3DADAPTER_IDENTIFIER9 구조체

어댑터를 식별하는 정보를 보관 유지한다.

구문

typedef struct _D3DADAPTER_IDENTIFIER9 {
    char Driver[MAX_DEVICE_IDENTIFIER_STRING];
    char Description[MAX_DEVICE_IDENTIFIER_STRING];
    char DeviceName[32];
    LARGE_INTEGER DriverVersion;
    DWORD DriverVersionLowPart;
    DWORD DriverVersionHighPart;
    DWORD VendorId;
    DWORD DeviceId;
    DWORD SubSysId;
    DWORD Revision;
    GUID DeviceIdentifier;
    DWORD WHQLLevel;
} D3DADAPTER_IDENTIFIER9;

멤버

Driver
사용자에 제시하기 위해서 사용된다. 다른 벤더로부터 제공되고 있는 동종의 장치 및 드라이버에 대해서 많은 다른 캐릭터 라인을 관련지을 수 있고 있을 가능성이 있기 (위해)때문에, 특정의 드라이버를 식별하기 위해서 이 멤버를 사용해서는 안된다.
Description
사용자에 제시하기 위해서 사용된다.
DeviceName
Microsoft® Windows® Graphics Device Interface (GDI)에 대한 장치명.
DriverVersion
Microsoft Direct3D® 드라이버의 버전을 식별한다. 64 비트의 부호 첨부 정수값으로 대소 비교를 실시해도 문제는 없다. 다만, 이 요소를 사용해 의심스러운 드라이버를 식별하는 경우는, 주의해 실시하는 것. 이 값은 아니고,DeviceIdentifier 를 사용하는 쪽이 바람직하다. 「주의」를 참조할것.
DriverVersionLowPart
Direct3D 드라이버의 버전을 식별한다. 64 비트의 부호 첨부 정수값으로 < 및 > 에 의한 대소 비교를 실시해도 문제는 없다. 다만, 이 요소를 사용해 의심스러운 드라이버를 식별하는 경우는, 주의해 실시하는 것. 이 값은 아니고,DeviceIdentifier 를 사용하는 것이 바람직하다. 「주의」를 참조할것.
DriverVersionHighPart
Direct3D 드라이버의 버전을 식별한다. 64 비트의 부호 첨부 정수값으로 < 및 > 에 의한 대소 비교를 실시해도 문제는 없다. 다만, 이 요소를 사용해 의심스러운 드라이버를 식별하는 경우는, 주의해 실시하는 것. 이 값은 아니고,DeviceIdentifier 를 사용하는 것이 바람직하다. 「주의」를 참조할것.
VendorId
특정의 칩 세트의 식별로 사용할 수 있다. 메이커를 식별하려면 , 이 멤버를 조사한다. 불명한 경우, 이 값은 0 이 되는 경우가 있다.
DeviceId
특정의 칩 세트의 식별로 사용할 수 있다. 칩 세트의 종류를 식별하려면 , 이 멤버를 조사한다. 불명한 경우, 이 값은 0 이 되는 경우가 있다.
SubSysId
특정의 칩 세트의 식별로 사용할 수 있다. 서브 시스템을 식별하려면 , 이 멤버를 조사한다. 일반적으로, 서브 시스템과는 특정의 보드를 가리킨다. 불명한 경우, 이 값은 0 이 되는 경우가 있다.
Revision
특정의 칩 세트의 식별로 사용할 수 있다. 칩 세트의 리버전 레벨을 식별하려면 , 이 멤버를 조사한다. 불명한 경우, 이 값은 0 이 되는 경우가 있다.
DeviceIdentifier
이 멤버를 조사하면 드라이버 및 칩 세트의 변경을 확인할 수 있다. 글로벌 유니크 식별자 (GUID)는, 드라이버와 칩 세트의 페어에 대한 일의인 식별자이다. 드라이버 및 칩 세트에의 변경을 추적해, 그래픽스 서브시스템 의 새로운 프로파일을 생성 하는 경우는, 이 멤버를 참조한다. DeviceIdentifier 는, 특정의 의심스러운 드라이버를 식별하기 위해서도 사용할 수 있다.
WHQLLevel
이 장치와 드라이버의 페어의 Windows Hardware Quality Labs (WHQL) 타당성 레벨을 특정하기 위해서 사용한다. DWORD 에는 일자가 팩 형식에서 저장 되고 있어 드라이버가 합격한 최신의 WHQL 테스트의 릴리스일이 정의되고 있다. 이 값에 대해서 대소 비교 연산을 실행해도 문제는 없다. 이하는, 일자의 포맷을 나타내고 있다.
비트
31-16 년. 1999 이상의 십진수.
15-8 월. 1 ~ 12 의 십진수.
7-0 일. 1 ~ 31 의 십진수.
다음의 값도 사용된다.
0 인증되지 않다.
1 WHQL 의 인증은 받고 있지만, 이용할 수 있는 일자 정보는 없다.

비트
31-16	년. 1999 이상의 십진수.
15-8	월. 1 ~ 12 의 십진수.
7-0	일. 1 ~ 31 의 십진수.

주의

다음의 유사 코드의 예는,DriverVersion,DriverVersionLowPart,DriverVersionHighPart 멤버에 encode 되는 버전의 포맷을 나타낸 것이다.
Product = HIWORD(DriverVersion.HighPart)
Version = LOWORD(DriverVersion.HighPart)
SubVersion = HIWORD(DriverVersion.LowPart)
Build = LOWORD(DriverVersion.LowPart)
HIWORD 매크로,LOWORD 매크로,LARGE_INTEGER 구조체의 더 자세한 정보는, Microsoft Platform Software Development Kit (SDK)를 참조할것.
정수 MAX_DEVICE_IDENTIFIER_STRING 는, 다음과 같이 정의되고 있다.
#define MAX_DEVICE_IDENTIFIER_STRING        512
VendorId,DeviceId,SubSysId,Revision 의 각 멤버를 조합해 사용하는 것으로, 특정의 칩 세트를 식별할 수 있다. 다만, 이러한 멤버를 사용할 때는 주의가 필요하다.

구조체의 정보

헤더 d3d9types.h
최저한의 operating system Windows 98

0	인증되지 않다.
1	WHQL 의 인증은 받고 있지만, 이용할 수 있는 일자 정보는 없다.