Bagikan melalui

enumerasi DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)

  • Artikel

Enumerasi DXGK_QUERYADAPTERINFOTYPE menunjukkan jenis informasi driver miniport tampilan mode kernel (KMD) harus kembali dalam buffer yang ditunjukkan pOutputData ketika fungsi DxgkDdiQueryAdapterInfo dipanggil. Lihat DXGKARG_QUERYADAPTERINFO untuk detail mengenai jenis yang memerlukan input (pInputData).

Sintaks

typedef enum _DXGK_QUERYADAPTERINFOTYPE {
  DXGKQAITYPE_UMDRIVERPRIVATE = 0,
  DXGKQAITYPE_DRIVERCAPS = 1,
  DXGKQAITYPE_QUERYSEGMENT = 2,
  DXGKQAITYPE_RESERVED = 3,
  DXGKQAITYPE_QUERYSEGMENT2 = 4,
  DXGKQAITYPE_QUERYSEGMENT3 = 5,
  DXGKQAITYPE_NUMPOWERCOMPONENTS = 6,
  DXGKQAITYPE_POWERCOMPONENTINFO = 7,
  DXGKQAITYPE_PREFERREDGPUNODE = 8,
  DXGKQAITYPE_POWERCOMPONENTPSTATEINFO = 9,
  DXGKQAITYPE_HISTORYBUFFERPRECISION = 10,
  DXGKQAITYPE_QUERYSEGMENT4 = 11,
  DXGKQAITYPE_SEGMENTMEMORYSTATE = 12,
  DXGKQAITYPE_GPUMMUCAPS = 13,
  DXGKQAITYPE_PAGETABLELEVELDESC = 14,
  DXGKQAITYPE_PHYSICALADAPTERCAPS = 15,
  DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION = 16,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR = 17,
  DXGKQAITYPE_UEFIFRAMEBUFFERRANGES = 18,
  DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES = 19,
  DXGKQAITYPE_DISPLAYID_DESCRIPTOR = 20,
  DXGKQAITYPE_FRAMEBUFFERSAVESIZE = 21,
  DXGKQAITYPE_HARDWARERESERVEDRANGES = 22,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2 = 23,
  DXGKQAITYPE_NODEPERFDATA = 24,
  DXGKQAITYPE_ADAPTERPERFDATA = 25,
  DXGKQAITYPE_ADAPTERPERFDATA_CAPS = 26,
  DXGKQAITYPE_GPUVERSION = 27,
  DXGKQAITYPE_DEVICE_TYPE_CAPS = 28,
  DXGKQAITYPE_WDDMDEVICECAPS = 29,
  DXGKQAITYPE_GPUPCAPS = 30,
  DXGKQAITYPE_QUERYTARGETGAMMACAPS = 31,
  DXGKQAITYPE_SCANOUT_CAPS = 33,
  DXGKQAITYPE_PHYSICAL_MEMORY_CAPS = 34,
  DXGKQAITYPE_IOMMU_CAPS = 35,
  DXGKQAITYPE_HARDWARERESERVEDRANGES2 = 36,
  DXGKQAITYPE_NATIVE_FENCE_CAPS = 37,
  DXGKQAITYPE_USERMODESUBMISSION_CAPS = 38,
  DXGKQAITYPE_DIRTYBITTRACKINGCAPS = 39,
  DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS = 40,
  DXGKQAITYPE_SCATTER_RESERVE = 41,
  DXGKQAITYPE_QUERYPAGINGBUFFERINFO,
  DXGKQAITYPE_QUERYSEGMENTCOUNT,
  DXGKQAITYPE_QUERYSEGMENT5,
  DXGKQAITYPE_QUERYMMUCOUNT,
  DXGKQAITYPE_QUERYMMUS,
  DXGKQAITYPE_64BITONLYCAPS,
  DXGKQAITYPE_PAGINGPROCESSGPUVASIZE
} DXGK_QUERYADAPTERINFOTYPE;

Konstanta

 
DXGKQAITYPE_UMDRIVERPRIVATE
Nilai: 0
Menunjukkan struktur data privat yang ditentukan kepemilikan untuk driver tampilan.
DXGKQAITYPE_DRIVERCAPS
Nilai: 1
KMD harus mengisi struktur DXGK_DRIVERCAPS dengan kemampuan drivernya.
DXGKQAITYPE_QUERYSEGMENT
Nilai: 2
KMD harus mengisi struktur DXGK_QUERYSEGMENTOUT dengan informasi segmen memorinya.
DXGKQAITYPE_RESERVED
Nilai: 3
Dicadangkan untuk penggunaan sistem. Jangan gunakan di driver Anda. Konstanta ini terjadi mulai dari Windows 7.
DXGKQAITYPE_QUERYSEGMENT2
Nilai: 4
Dicadangkan untuk penggunaan sistem. Jangan gunakan di driver Anda. Konstanta ini terjadi mulai dari Windows 7.
DXGKQAITYPE_QUERYSEGMENT3
Nilai: 5
KMD harus mengisi struktur DXGK_QUERYSEGMENTOUT3 dengan informasi segmen memori. Didukung mulai dari Windows 8.
DXGKQAITYPE_NUMPOWERCOMPONENTS
Nilai: 6
Miniport tampilan harus menyediakan nilai UINT yang menentukan jumlah komponen daya yang digunakannya. Didukung mulai dari Windows 8.
DXGKQAITYPE_POWERCOMPONENTINFO
Nilai: 7
KMD harus mengisi struktur DXGK_POWER_RUNTIME_COMPONENT dengan informasi tentang komponen daya ke-n, di mana n adalah indeks komponen yang ditentukan oleh DXGKARG_QUERYADAPTERINFO.pInputData dalam panggilan ke DxgkDdiQueryAdapterInfo. Didukung mulai dari Windows 8.
DXGKQAITYPE_PREFERREDGPUNODE
Nilai: 8
Dicadangkan untuk penggunaan sistem. Jangan gunakan di driver Anda. Konstanta ini terjadi mulai dari Windows 8.
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO
Nilai: 9
Dicadangkan untuk penggunaan sistem. Jangan gunakan di driver Anda. Didukung mulai dari Windows 8.1.
DXGKQAITYPE_HISTORYBUFFERPRECISION
Nilai: 10
KMD harus mengisi struktur DXGKARG_HISTORYBUFFERPRECISION dengan informasi tentang presisi data buffer riwayat yang digunakannya. Didukung mulai dari Windows 8.1.
DXGKQAITYPE_QUERYSEGMENT4
Nilai: 11
KMD harus mengisi struktur DXGK_QUERYSEGMENTOUT4 untuk menunjukkan informasi segmen memorinya. Didukung mulai dari Windows 10.
DXGKQAITYPE_SEGMENTMEMORYSTATE
Nilai: 12
KMD harus mengisi struktur DXGK_MEMORYRANGE dengan rentang memori yang buruk. Didukung mulai dari Windows 10.
DXGKQAITYPE_GPUMMUCAPS
Nilai: 13
KMD harus mengisi struktur DXGK_GPUMMUCAPS dengan kemampuan manajemen memori virtualnya. Didukung mulai dari Windows 10.
DXGKQAITYPE_PAGETABLELEVELDESC
Nilai: 14
Dicadangkan untuk penggunaan sistem. Jangan gunakan di driver Anda. Konstanta ini terjadi mulai dari Windows 10.
DXGKQAITYPE_PHYSICALADAPTERCAPS
Nilai: 15
Dicadangkan untuk penggunaan sistem. Jangan gunakan di driver Anda. Konstanta ini terjadi mulai dari Windows 10.
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION
Nilai: 16
Dicadangkan untuk penggunaan sistem. Jangan gunakan di driver Anda. Konstanta ini terjadi mulai dari Windows 10.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR
Nilai: 17
Didukung mulai Windows 10, versi 1703. Menunjukkan permintaan untuk deskriptor panel terintegrasi di mana buffer input ke kueri akan menjadi struktur DXGK_QUERYINTEGRATEDDISPLAYIN dan buffer output adalah struktur DXGK_QUERYINTEGRATEDDISPLAYOUT .

Meskipun fungsi ini mengatasi target, hanya kunci adaptor DxgKrnl yang diambil alih panggilan ini, bukan kunci perangkat anak. Dalam praktiknya, karena panggilan ini akan dilakukan sebelum perangkat anak terekspos, seharusnya tidak ada panggilan DDI bersamaan yang membahas target yang sama.

CATATAN: Tidak seperti kebanyakan panggilan QueryAdapterInfo, ukuran buffer output bervariasi meskipun masih diketahui terlebih dahulu dari bidang DescriptorLength dari struktur DXGK_INTEGRATED_DISPLAY_CHILD untuk id target. Ukuran buffer output adalah:
DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES
Nilai: 18
Menunjukkan permintaan untuk rentang buffer bingkai UEFI. Didukung mulai Windows 10, versi 1703.
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES
Nilai: 19
Didukung mulai Windows 10, versi 1703. Menunjukkan permintaan penimpaan colorimetry untuk tampilan eksternal, di mana buffer input ke kueri akan menjadi struktur DXGK_QUERYCOLORIMETRYOVERRIDESIN , hanya berisi id target yang ditangani dan buffer output adalah struktur DXGK_COLORIMETRY tempat driver menulis ambil alih untuk monitor yang dilampirkan ke target.

Meskipun fungsi ini mengatasi target, hanya kunci adaptor DxgKrnl yang diambil alih panggilan ini, bukan kunci perangkat anak. Karena panggilan ini akan dilakukan sebelum perangkat anak terekspos, seharusnya tidak ada panggilan DDI bersamaan yang menangani target yang sama.

Buffer output di-nol ketika diteruskan ke driver. Jika driver tidak memiliki penimpaan untuk monitor, driver harus mengembalikan STATUS_SUCCESS dan membiarkan buffer output nol. Jika driver memiliki penimpaan, driver mengisi semua bidang DXGK_COLORIMETRY untuk menggambarkan kemampuan monitor karena OS tidak akan menerima penimpaan parsial.
DXGKQAITYPE_DISPLAYID_DESCRIPTOR
Nilai: 20
Menunjukkan permintaan untuk deskriptor panel terintegrasi di mana buffer input ke kueri akan menjadi struktur DXGK_QAITARGETIN dan buffer output adalah struktur DXGK_QUERYINTEGRATEDDISPLAYOUT . Didukung mulai Windows 10, versi 1709.
DXGKQAITYPE_FRAMEBUFFERSAVESIZE
Nilai: 21
KMD harus mengisi struktur DXGK_FRAMEBUFFERSAVEAREA dengan ukuran buffer bingkai untuk disimpan ke memori sistem selama transisi daya. Didukung mulai dari Windows 10, versi 1803.
DXGKQAITYPE_HARDWARERESERVEDRANGES
Nilai: 22
KMD harus mengisi struktur DXGK_HARDWARERESERVEDRANGES dengan rentang memori yang dipesan perangkat kerasnya. Didukung mulai dari Windows 10, versi 1803.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2
Nilai: 23
Didukung mulai dari Windows 10, versi 1803. Menunjukkan permintaan untuk deskriptor panel terintegrasi di mana buffer input ke kueri akan menjadi struktur DXGK_QAITARGETIN dan buffer output adalah struktur DXGK_QUERYINTEGRATEDDISPLAYOUT2 . Kueri ini menggantikan penggunaan kueri DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR untuk driver WDDM 2.4.

Perangkat turunan TypeIntegratedDisplay dilaporkan dengan memanggil DxgkDdiQueryAdapterInfo dengan Jenis diatur ke nilai ini.
DXGKQAITYPE_NODEPERFDATA
Nilai: 24
KMD harus mengisi struktur DXGK_NODE_PERFDATA yang mewakili data performa yang dikumpulkan per mesin dari adaptor secara interval. Didukung mulai dari Windows 10, versi 1803.
DXGKQAITYPE_ADAPTERPERFDATA
Nilai: 25
KMD harus mengisi struktur DXGK_ADAPTER_PERFDATA yang mewakili data performa yang dikumpulkan per adaptor secara interval. Didukung mulai dari Windows 10, versi 1803.
DXGKQAITYPE_ADAPTERPERFDATA_CAPS
Nilai: 26
KMD harus mengisi struktur DXGK_ADAPTER_PERFDATACAPS yang mewakili kemampuan data yang statis dan dikueri sekali per GPU selama inisialisasi. Didukung mulai dari Windows 10, versi 1803.
DXGKQAITYPE_GPUVERSION
Nilai: 27
KMD harus mengisi struktur DXGK_GPUVERSION yang digunakan untuk mengumpulkan versi BIOS dan nama arsitektur GPU sekali selama inisialisasi GPU. Didukung mulai dari Windows 10, versi 1803.
DXGKQAITYPE_DEVICE_TYPE_CAPS
Nilai: 28
KMD harus mengisi struktur DXGK_DEVICE_TYPE_CAPS yang menjelaskan jenis kemampuan untuk perangkat. Didukung mulai Windows 10, versi 1809.
DXGKQAITYPE_WDDMDEVICECAPS
Nilai: 29
KMD harus mengisi struktur DXGK_WDDMDEVICECAPS yang berisi kemampuan WDDM yang dikueri oleh OS selama inisialisasi perangkat. Didukung mulai Windows 10, versi 1903.
DXGKQAITYPE_GPUPCAPS
Nilai: 30
KMD harus mengisi struktur DXGK_GPUPCAPS yang berisi kemampuan GPU untuk driver tampilan mode kernel. Didukung mulai Windows 10, versi 1903.
DXGKQAITYPE_QUERYTARGETGAMMACAPS
Nilai: 31
KMD harus mengisi struktur DXGK_TARGET_GAMMA_CAPS yang menjelaskan kemampuan gamma KMD. Didukung mulai Windows 10, versi 1903.
DXGKQAITYPE_SCANOUT_CAPS
Nilai: 33
KMD harus mengisi struktur DXGK_QUERY_SCANOUT_CAPS_OUT yang menjelaskan kemampuan pemindaian driver. Didukung mulai Windows 10, versi 1903.
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS
Nilai: 34
KMD harus mengisi struktur DXGK_PHYSICAL_MEMORY_CAPS yang menjelaskan pembatasan memori fisik (alamat fisik tertinggi yang terlihat) perangkat. Didukung mulai Windows Server 2022 (WDDM 2.9).

Lihat DXGKQAITYPE_IOMMU_CAPS untuk detail tentang cara menunjukkan dukungan driver untuk pemilahan linier IOMMU.
DXGKQAITYPE_IOMMU_CAPS
Nilai: 35
KMD harus mengisi struktur DXGK_IOMMU_CAPS yang menunjukkan bahwa pemetakan ulang linier IOMMU didukung oleh driver. Didukung mulai Windows Server 2022 (WDDM 2.9). Untuk menunjukkan dukungan untuk pemecahan ulang linier, driver juga harus memberi tahu Dxgkernel tentang pembatasan memori fisiknya melalui batas DXGKQAITYPE_PHYSICAL_MEMORY_CAPS .

Remapping logis hanya dapat dilakukan jika tidak ada memori fisik yang direferensikan oleh perangkat, sehingga urutan panggilan Dxgkrnl adalah sebagai berikut:

* Panggil DxgkDdiAddDevice untuk semua adaptor fisik, sehingga driver dapat mengumpulkan informasi untuk semua adaptor fisik yang ditautkan.

* Panggil DxgkDdiQueryAdapterInfo dengan DXGKQAITYPE_PHYSICAL_MEMORY_CAPS dan DXGKQAITYPE_IOMMU_CAPS sehingga kemudian dapat membuat dan melampirkan perangkat ke domain IOMMU sebelum memori apa pun dapat diakses.

* Panggil DxgkDdiStartDevice untuk memulai perangkat.
DXGKQAITYPE_HARDWARERESERVEDRANGES2
Nilai: 36
DXGKQAITYPE_NATIVE_FENCE_CAPS
Nilai: 37
KMD harus mengisi struktur DXGK_NATIVE_FENCE_CAPS yang berisi detail dukungan driver untuk pagar GPU asli. Didukung mulai dari Windows 11, versi 24H2. Untuk informasi selengkapnya, lihat Pagar GPU asli.
DXGKQAITYPE_USERMODESUBMISSION_CAPS
Nilai: 38
KMD harus mengisi struktur DXGK_USERMODESUBMISSION_CAPS yang berisi detail dukungan driver untuk pengiriman kerja mode pengguna. Didukung mulai dari Windows 11, versi 24H2. Untuk informasi selengkapnya, lihat Pengiriman kerja mode pengguna.
DXGKQAITYPE_DIRTYBITTRACKINGCAPS
Nilai: 39
KMD harus mengisi struktur DXGK_DIRTY_BIT_TRACKING_CAPS yang berisi detail dukungan driver untuk pelacakan bit kotor. Didukung mulai dari Windows 11, versi 24H2. Untuk informasi selengkapnya, lihat Pelacakan bit kotor.
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS
Nilai: 40
KMD harus mengisi struktur DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS yang berisi detail dukungan driver untuk pelacakan bit kotor pada segmen memori tertentu. Didukung mulai dari Windows 11, versi 24H2. Untuk informasi selengkapnya, lihat Pelacakan bit kotor.
DXGKQAITYPE_SCATTER_RESERVE
Nilai: 41
KMD harus mengisi struktur DXGK_QUERYSCATTERRESERVEOUT yang berisi detail dukungan driver untuk cadangan sebar. Didukung mulai dari Windows 11, versi 24H2. Untuk informasi selengkapnya, lihat Migrasi langsung di perangkat GPU-P.

Keterangan

Dxgkrnl memanggil panggilan balik DxgkDdiQueryAdapterInfo KMD untuk mengambil informasi konfigurasi dari adaptor grafis. Driver mengisi informasi yang diminta dalam buffer yang diacu oleh anggota pOutputData dari struktur DXGKARG_QUERYADAPTERINFO . Lihat setiap nilai enumerasi untuk jenis struktur yang akan diisi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Header d3dkmddi.h (termasuk D3dkmddi.h)

Lihat juga

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo