DXGKDDI_QUERY_INTERFACE fungsi panggilan balik (dispmprt.h)

Artikel
05/23/2024

Fungsi DxgkDdiQueryInterface mengembalikan antarmuka fungsi yang diimplementasikan oleh driver miniport tampilan.

Sintaks

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

NTSTATUS DxgkddiQueryInterface(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] IN_PQUERY_INTERFACE QueryInterface
)
{...}

Parameter

[in] MiniportDeviceContext

Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya menyediakan handel ini ke Dxgkrnl.

[in] QueryInterface

Penunjuk ke struktur QUERY_INTERFACE di mana driver miniport tampilan harus mengembalikan informasi tentang antarmuka yang didukungnya.

Menampilkan nilai

DxgkDdiQueryInterface mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan kode NTSTATUS yang sesuai. Jika driver miniport tampilan tidak mendukung antarmuka yang diminta, driver harus mengembalikan STATUS_NOT_SUPPORTED. Dengan mengembalikan STATUS_NOT_SUPPORTED, driver miniport tampilan memberi tahu sistem operasi untuk meneruskan kueri ke driver berikutnya.

Keterangan

DxgkDdiQueryInterface memaparkan mekanisme komunikasi antara driver miniport tampilan dan driver perangkat anak (misalnya, perangkat pengambilan video). Driver miniport tampilan yang mengekspos mekanisme seperti itu harus menerapkan fungsi ini.

DxgkDdiQueryInterface harus mengisi anggota struktur ANTARMUKA yang dituju oleh QueryInterface-Interface> sebagai berikut:

Atur Ukuran ke jumlah byte dalam struktur INTERFACE. Nilai ini tidak boleh melebihi jumlah byte yang ditentukan oleh QueryInterface-Size>.
Atur Versi ke versi antarmuka yang dikembalikan oleh driver miniport tampilan. Driver miniport tampilan harus paling cocok dengan versi yang diminta oleh driver anak di QueryInterface-Version>.
Atur Konteks untuk menunjuk ke konteks tampilan yang ditentukan driver miniport untuk antarmuka. Biasanya, driver miniport tampilan akan mengatur Konteks ke handel ke blok konteks adaptor tampilan yang diidentifikasi oleh MiniportDeviceContext.
Inisialisasi InterfaceReference dan InterfaceDereference untuk menunjuk ke rutinitas referensi dan dereferensi yang diimplementasikan driver miniport tampilan untuk antarmuka ini.
Inisialisasi semua anggota khusus antarmuka tambahan untuk menunjuk ke rutinitas antarmuka yang sesuai yang sedang diekspos.