DXGKDDI_QUERYADAPTERINFO fungsi panggilan balik (d3dkmddi.h)
Fungsi DxgkDdiQueryAdapterInfo tampilan miniport (KMD) mengambil informasi konfigurasi dari adaptor grafis.
Sintaks
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
Parameter
[in] hAdapter
Handel ke blok konteks yang terkait dengan adaptor tampilan. KMD sebelumnya menyediakan handel ini ke Dxgkrnl dalam parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .
[in] pQueryAdapterInfo
Penunjuk ke struktur DXGKARG_QUERYADAPTERINFO yang diisi KMD dengan informasi konfigurasi untuk adaptor grafis.
Menampilkan nilai
DxgkDdiQueryAdapterInfo mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_SUCCESS | DxgkDdiQueryAdapterInfo berhasil mengambil informasi konfigurasi. |
| STATUS_INVALID_PARAMETER | Parameter yang diteruskan ke DxgkDdiQueryAdapterInfo berisi kesalahan yang mencegahnya selesai. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Driver miniport tampilan tidak kompatibel dengan driver tampilan mode pengguna yang memulai panggilan ke DxgkDdiQueryAdapterInfo (yaitu, menyediakan data privat untuk kueri ke driver miniport tampilan). |
Keterangan
Ketika driver tampilan mode pengguna memanggil fungsi pfnQueryAdapterInfoCb , panggilan ke fungsi DxgkDdiQueryAdapterInfo dimulai.
Jika DxgkDdiQueryAdapterInfo menerima nilai DXGKQAITYPE_UMDRIVERPRIVATE dalam jenis anggota struktur DXGKARG_QUERYADAPTERINFO yang dirujuk parameter pQueryAdapterInfo , pOutputData menunjuk ke struktur kepemilikan yang diisi KMD dengan informasi konfigurasi yang diperlukan driver tampilan mode pengguna untuk mengidentifikasi adaptor.
Jika Dxgkrnl menentukan nilai DXGKQAITYPE_DRIVERCAPS dalam jenis anggota DXGKARG_QUERYADAPTERINFO ketika subsistem memanggil DxgkDdiQueryAdapterInfo, driver miniport tampilan harus mengisi struktur DXGK_DRIVERCAPS yang disediakan dengan informasi yang dapat digunakan subsistem.
Jika subsistem kernel grafis DirectX memasok nilai DXGKQAITYPE_QUERYSEGMENT dalam jenis anggota DXGKARG_QUERYADAPTERINFO, driver miniport tampilan harus memberikan informasi tentang segmen memori yang didukungnya. Untuk informasi selengkapnya tentang segmen memori, lihat Menginisialisasi Penggunaan Segmen Memori.
DxgkDdiQueryAdapterInfo harus dibuat dapat di-pageable.
Semua driver yang mendukung WDDM 2.6 dan yang lebih besar harus mengimplementasikan panggilan balik DxgkDdiQueryAdapterInfo .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Target Platform | Desktop |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |