DXGKDDI_QUERYADAPTERINFO fungsi panggilan balik (d3dkmddi.h)

Fungsi DxgkDdiQueryAdapterInfo 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. Driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis Microsoft DirectX di parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

[in] pQueryAdapterInfo

Penunjuk ke struktur DXGKARG_QUERYADAPTERINFO yang diisi driver miniport tampilan dengan informasi konfigurasi untuk adaptor grafis.

Mengembalikan 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. DxgkDdiQueryAdapterInfo menerima nilai DXGKQAITYPE_UMDRIVERPRIVATE dalam jenis anggota struktur DXGKARG_QUERYADAPTERINFO yang ditunjukkan parameter pQueryAdapterInfo . Fungsi ini juga menerima buffer kepemilikan di anggota pOutputData yang diisinya dengan informasi konfigurasi yang diperlukan bagi driver tampilan mode pengguna untuk mengidentifikasi adaptor.

Jika subsistem kernel grafik DirectX (yang merupakan bagian dari Dxgkrnl.sys) 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 dipaginasi.

Catatan

Semua driver yang mendukung WDDM 2.6 harus menerapkan panggilan balik DxgkDdiQueryAdapterInfo.

Persyaratan

   
Klien minimum yang didukung Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru.
Target Platform Desktop
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

Lihat juga

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb