DriverEntry dari fungsi Driver Video Miniport

Artikel
06/15/2023

DriverEntry adalah titik masuk awal ke dalam driver miniport video.

Sintaks

ULONG DriverEntry(
  _In_ PVOID Context1,
  _In_ PVOID Context2
);

Parameter

Context1 [in] Penunjuk ke nilai konteks tempat driver miniport harus memanggil VideoPortInitialize. Nilai konteks ini mengidentifikasi objek driver yang dibuat oleh sistem untuk driver miniport ini.

Context2 [in] Penunjuk ke nilai konteks kedua di mana driver miniport harus memanggil VideoPortInitialize. Nilai konteks ini mengidentifikasi jalur registri untuk driver miniport ini.

Mengembalikan nilai

DriverEntry mengembalikan nilai yang dikembalikan oleh VideoPortInitialize.

Keterangan

Setiap driver miniport harus memiliki fungsi bernama DriverEntry secara eksplisit agar dapat dimuat. DriverEntry dipanggil langsung oleh sistem I/O.

DriverEntry harus melakukan langkah-langkah berikut:

Alokasikan memori pada tumpukan untuk struktur VIDEO_HW_INITIALIZATION_DATA , dan panggil VideoPortZeroMemory untuk menginisialisasinya nol.
Isi nilai khusus driver dan khusus adaptor di anggota VIDEO_HW_INITIALIZATION_DATA, termasuk titik masuk driver miniport. Titik masuk berikut harus diatur ke rutinitas yang disediakan pengemudi miniport:

HwVidFindAdapter

HwVidInitialize

HwVidStartIO

HwVidInterrupt

HwVidQueryInterface

HwVidGetVideoChildDescriptor

HwVidGetPowerState

HwVidSetPowerState
Jika perangkat keras driver mendukung sumber daya warisan, driver harus melaporkannya. DriverEntry harus melakukan hal berikut jika daftar sumber daya diketahui pada waktu kompilasi driver:
- Klaim dan laporkan semua sumber daya tersebut di anggota HwLegacyResourceList dan HwLegacyResourceCount dari struktur VIDEO_HW_INITIALIZATION_DATA . Sumber daya warisan adalah sumber daya yang tidak tercantum di ruang konfigurasi PCI perangkat tetapi yang didekodekan oleh perangkat.
- Isi bidang RangePassive yang sesuai untuk setiap struktur VIDEO_ACCESS_RANGE yang ditentukan dalam driver miniport.
Jika daftar sumber daya warisan tidak dapat ditentukan hingga durasi, driver harus menerapkan fungsi HwVidLegacyResources untuk melaporkannya.
Panggil VideoPortInitialize, melewati Context1 dan Context2 sebagai dua parameter pertama, penunjuk ke struktur VIDEO_HW_INITIALIZATION_DATA sebagai parameter ketiga, dan NULL sebagai parameter keempat.

DriverEntry harus menyebarluaskan nilai yang dikembalikan oleh VideoPortInitialize kembali ke pemanggil.

Jika DriverEntry mengklaim sumber daya, itu harus mencakup hanya sumber daya yang didekode perangkat keras tetapi yang tidak diklaim oleh PCI. Driver miniport dapat "mengklaim kembali" sumber daya warisan ini lagi dalam panggilan berikutnya ke VideoPortVerifyAccessRanges; namun, driver port video hanya akan mengabaikan permintaan untuk sumber daya yang diklaim sebelumnya. Manajemen daya dan docking akan dinonaktifkan dalam sistem jika driver miniport mencoba untuk mengklaim rentang akses lama di VideoPortVerifyAccessRanges yang sebelumnya tidak diklaim di anggota HwLegacyResourceList dari struktur VIDEO_HW_INITIALIZATION_DATA selama DriverEntry (atau di HwVidLegacyResources, jika diimplementasikan).

Untuk driver Microsoft Windows 2000 dan yang lebih baru yang juga mendukung komputer yang menjalankan Windows NT 4.0, konstanta konfigurasi perangkat keras ditentukan dalam video.h. Konstanta ini dijelaskan dalam tabel berikut.

Terus-menerus	Makna
SIZE_OF_NT4_VIDEO_PORT_CONFIG_INFO	Ukuran, dalam byte, dari struktur VIDEO_PORT_CONFIG_INFO Windows NT 4.0.
SIZE_OF_NT4_VIDEO_HW_INITIALIZATION_DATA	Ukuran, dalam byte, dari struktur VIDEO_HW_INITIALIZATION_DATA Windows NT 4.0. Jika VideoPortInitialize gagal, driver miniport video harus mengatur anggota HwInitDataSize dari struktur VIDEO_HW_INITIALIZATION_DATA ke ukuran versi Windows 2000 (dan yang lebih baru) dari struktur ini atau versi Windows NT 4.0. Pilih ukuran struktur yang sesuai untuk mencocokkan versi sistem operasi tempat driver miniport akan berjalan. Driver miniport video kemudian harus memanggil VideoPortInitialize lagi. Untuk contoh penggunaan, silakan lihat sampel driver miniport video yang disertakan dalam Windows Driver Development Kit (DDK).
SIZE_OF_W2K_VIDEO_HW_INITIALIZATION_DATA	Ukuran, dalam byte, dari Struktur VIDEO_HW_INITIALIZATION_DATA Windows 2000 dan yang lebih baru.
SIZE_OF_WXP_VIDEO_HW_INITIALIZATION_DATA	Ukuran, dalam byte, dari Windows Vista dan struktur VIDEO_HW_INITIALIZATION_DATA yang lebih baru.
SIZE_OF_WXP_VIDEO_PORT_CONFIG_INFO	Ukuran, dalam byte, dari struktur VIDEO_PORT_CONFIG_INFO Windows Vista.