DXGKDDI_ADD_DEVICE fungsi panggilan balik (dispmprt.h)

  • Artikel

Fungsi DxgkDdiAddDevice membuat blok konteks untuk adaptor tampilan dan mengembalikan handel yang mewakili adaptor tampilan.

Sintaks

DXGKDDI_ADD_DEVICE DxgkddiAddDevice;

NTSTATUS DxgkddiAddDevice(
  [in]  IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
  [out] OUT_PPVOID MiniportDeviceContext
)
{...}

Parameter

[in] PhysicalDeviceObject

Penunjuk ke objek perangkat fisik (PDO) yang mengidentifikasi adaptor tampilan.

[out] MiniportDeviceContext

Penunjuk ke variabel yang menerima handel, yang dibuat oleh driver miniport tampilan, yang akan mewakili adaptor tampilan yang diidentifikasi oleh PhysicalDeviceObject. Driver miniport tampilan dapat mengembalikan NULL dalam parameter ini untuk menunjukkan bahwa ia tidak akan mendukung adaptor tampilan yang diidentifikasi oleh PhysicalDeviceObject.

Nilai kembali

DxgkDdiAddDevice mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Fungsi DxgkDdiAddDevice mengalokasikan blok konteks privat yang terkait dengan adaptor tampilan yang diidentifikasi oleh PhysicalDeviceObject. Anda dapat menganggap handel yang dikembalikan di MiniportDeviceContext sebagai handel ke adaptor tampilan atau sebagai handel ke blok konteks yang terkait dengan adaptor tampilan. Subsistem kernel grafis DirectX (Dxgkrnl.sys) akan menyediakan handel dalam panggilan berikutnya ke driver miniport tampilan. Daftar berikut memberikan contoh berbagai komponen Dxgkrnl.sys meneruskan handel ke fungsi yang diterapkan oleh driver miniport tampilan.

Jangan bingung dengan fakta bahwa terkadang handel diberi nama MiniportDeviceContext dan terkadang diberi nama hAdapter. Selain itu, jangan bingung handel ini dengan parameter hDevice yang diteruskan ke fungsi driver miniport tampilan tertentu.

DxgkDdiAddDevice dipanggil untuk satu perangkat pada satu waktu secara serial. Perilakunya sama dengan panggilan balik DRIVER_ADD_DEVICE standar untuk driver mode kernel WDM.

Beberapa kartu adaptor tampilan memiliki dua fungsi PCI atau lebih yang memainkan peran adaptor tampilan. Misalnya, kartu lama tertentu menerapkan beberapa tampilan dengan memiliki fungsi PCI terpisah untuk setiap tampilan. Driver port tampilan memanggil DxgkDdiAddDevice sekali untuk setiap fungsi PCI tersebut, pada saat itu driver miniport tampilan dapat menunjukkan bahwa ia mendukung fungsi PCI (dengan mengatur MiniportDeviceContext ke nilai bukan nol) atau tidak mendukung fungsi PCI (dengan mengatur MiniportDeviceContext ke NULL). Untuk mendapatkan informasi tentang fungsi PCI tertentu, driver miniport tampilan dapat meneruskan PhysicalDeviceObject ke IoGetDeviceProperty.

Di DxgkDdiRemoveDevice, bebaskan blok konteks Anda dan sumber daya lain yang Anda alokasikan selama DxgkDdiAddDevice.

Fungsi DxgkDdiAddDevice harus dibuat dapat dipaginasi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Target Platform Desktop
Header dispmprt.h
IRQL PASSIVE_LEVEL

Lihat juga

DxgkDdiRemoveDevice

DxgkDdiStartDevice