enumerasi DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)
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) |