Bagikan melalui

struktur D3DADAPTER_IDENTIFIER9

  • Artikel

Berisi informasi yang mengidentifikasi adaptor.

Sintaks

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;

Anggota

Driver

Jenis: karakter

Digunakan untuk presentasi kepada pengguna. Ini tidak boleh digunakan untuk mengidentifikasi driver tertentu, karena banyak string yang berbeda mungkin dikaitkan dengan perangkat dan driver yang sama dari vendor yang berbeda.

Deskripsi

Jenis: karakter

Digunakan untuk presentasi kepada pengguna.

DeviceName

Jenis: karakter

Nama perangkat untuk GDI.

DriverVersion

Jenis: LARGE_INTEGER

Identifikasi versi driver Direct3D. Hukum untuk melakukan kurang dari dan lebih besar dari perbandingan pada nilai bilangan bulat bertanda tangan 64-bit. Namun, berhati-hatilah jika Anda menggunakan elemen ini untuk mengidentifikasi driver yang bermasalah. Sebagai gantinya, Anda harus menggunakan DeviceIdentifier. Lihat Keterangan.

DriverVersionLowPart

Jenis: DWORD

Identifikasi versi driver Direct3D. Hal ini legal untuk dilakukan < dan > perbandingan pada nilai bilangan bulat bertanda tangan 64-bit. Namun, berhati-hatilah jika Anda menggunakan elemen ini untuk mengidentifikasi driver yang bermasalah. Sebagai gantinya, Anda harus menggunakan DeviceIdentifier. Lihat Keterangan.

DriverVersionHighPart

Jenis: DWORD

Identifikasi versi driver Direct3D. Hal ini legal untuk dilakukan < dan > perbandingan pada nilai bilangan bulat bertanda tangan 64-bit. Namun, berhati-hatilah jika Anda menggunakan elemen ini untuk mengidentifikasi driver yang bermasalah. Sebagai gantinya, Anda harus menggunakan DeviceIdentifier. Lihat Keterangan.

VendorId

Jenis: DWORD

Dapat digunakan untuk membantu mengidentifikasi chip set tertentu. Kueri anggota ini untuk mengidentifikasi produsen. Nilainya bisa nol jika tidak diketahui.

DeviceId

Jenis: DWORD

Dapat digunakan untuk membantu mengidentifikasi chip set tertentu. Kueri anggota ini untuk mengidentifikasi jenis kumpulan chip. Nilainya bisa nol jika tidak diketahui.

SubSysId

Jenis: DWORD

Dapat digunakan untuk membantu mengidentifikasi chip set tertentu. Kueri anggota ini untuk mengidentifikasi subsistem, biasanya papan tertentu. Nilainya bisa nol jika tidak diketahui.

Revisi

Jenis: DWORD

Dapat digunakan untuk membantu mengidentifikasi chip set tertentu. Kueri anggota ini untuk mengidentifikasi tingkat revisi set chip. Nilainya bisa nol jika tidak diketahui.

DeviceIdentifier

Jenis: GUID

Dapat dikueri untuk memeriksa perubahan pada driver dan chip set. GUID ini adalah pengidentifikasi unik untuk pasangan set driver dan chip. Kueri anggota ini untuk melacak perubahan pada driver dan chip yang diatur untuk menghasilkan profil baru untuk subsistem grafis. DeviceIdentifier juga dapat digunakan untuk mengidentifikasi driver bermasalah tertentu.

WHQLLevel

Jenis: DWORD

Digunakan untuk menentukan tingkat validasi Windows Hardware Quality Labs (WHQL) untuk pasangan driver dan perangkat ini. DWORD adalah struktur tanggal kemasan yang menentukan tanggal rilis tes WHQL terbaru yang diloloskan oleh driver. Adalah hukum untuk melakukan < operasi dan > pada nilai ini. Berikut ini menggambarkan format tanggal.

Bit Deskripsi
31-16 Tahun, angka desimal dari 1999 ke atas.
15-8 Bulan, angka desimal dari 1 hingga 12.
7-0 Hari itu, angka desimal dari 1 hingga 31.

 

Nilai berikut juga digunakan.

Nilai Deskripsi
0 Tidak bersertifikat.
1 WHQL divalidasi, tetapi tidak ada informasi tanggal yang tersedia.

 

Perbedaan antara Direct3D 9 dan Direct3D 9Ex:

Untuk Direct3D9Ex yang berjalan pada Windows Vista, Windows Server 2008, Windows 7, dan Windows Server 2008 R2 (atau lebih sistem operasi saat ini), IDirect3D9::GetAdapterIdentifier mengembalikan 1 untuk tingkat WHQL tanpa memeriksa status driver.

Keterangan

Contoh pseudocode berikut mengilustrasikan format versi yang dikodekan dalam anggota DriverVersion, DriverVersionLowPart, dan DriverVersionHighPart.

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

Lihat Platform SDK untuk informasi selengkapnya tentang makro HIWORD, makro LOWORD, dan struktur LARGE_INTEGER.

MAX_DEVICE_IDENTIFIER_STRING adalah konstanta dengan definisi berikut.

#define MAX_DEVICE_IDENTIFIER_STRING        512

Anggota VendorId, DeviceId, SubSysId, dan Revisi dapat digunakan bersamaan untuk mengidentifikasi set chip tertentu. Namun, gunakan anggota ini dengan hati-hati.

Persyaratan

Persyaratan Nilai
Header
D3D9Types.h

Lihat juga

Struktur Direct3D