Fungsi WdfPreDeviceInstallEx (wdfinstaller.h)

Artikel
08/08/2023

[Hanya berlaku untuk KMDF]

Fungsi WdfPreDeviceInstallEx co-installer melakukan operasi apa pun yang mungkin diperlukan oleh penginstal bersama sebelum penginstal driver non-Plug and Play (PnP) membuat layanan mode kernel driver.

Sintaks

ULONG WdfPreDeviceInstallEx(
  [in]           LPCWSTR                          InfPath,
  [in, optional] LPCWSTR                          InfSectionName,
  [in]           PWDF_COINSTALLER_INSTALL_OPTIONS ClientOptions
);

Parameter

[in] InfPath

Penunjuk ke string karakter lebar yang dihentikan null yang berisi jalur direktori ke file INF driver. Penginstal driver dapat memperoleh string ini dengan memanggil GetCurrentDirectory, yang dijelaskan dalam Microsoft Windows SDK.

[in, optional] InfSectionName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama Wdf-install-section dalam file INF driver. Untuk informasi selengkapnya tentang nama ini, lihat Menggunakan Penginstal Bersama KMDF. Jika pointer ini ADALAH NULL, penginstal bersama menggunakan WdfSection untuk nama tersebut.

[in] ClientOptions

Penunjuk ke struktur WDF_COINSTALLER_INSTALL_OPTIONS yang dialokasikan penelepon yang berisi opsi penginstalan yang ditentukan driver.

Nilai kembali

WdfPreDeviceInstallEx mengembalikan ERROR_SUCCESS jika operasi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai ERROR_XXX tambahan yang ditentukan dalam Winerror.h.

Keterangan

Penginstal untuk driver berbasis kerangka kerja perangkat non-PnP harus memanggil WdfPreDeviceInstall atau WdfPreDeviceInstallEx sebelum alat penginstal memanggil CreateService.

Untuk mendapatkan alamat fungsi WdfPreDeviceInstallEx co-installer, penginstal harus memanggil GetProcAddress setelah penginstal memanggil LoadLibrary untuk memuat penginstal bersama.

Jika penginstal bersama menentukan bahwa komputer harus dimulai ulang untuk menyelesaikan penginstalan driver (biasanya karena versi kerangka kerja yang lebih lama sebelumnya diinstal), fungsi WdfPreDeviceInstallEx memungkinkan Anda mengontrol kapan atau apakah pengguna diminta untuk memulai ulang komputer, sebagai berikut:

Jika penginstal mengatur anggota ShowRebootPrompt dari struktur WDF_COINSTALLER_INSTALL_OPTIONS ke TRUE, WdfPreDeviceInstallEx memberi tahu manajer PnP bahwa komputer harus dimulai ulang, dan manajer PnP meminta pengguna bahwa hidupkan ulang diperlukan. Mengatur anggota ShowRebootPrompt ke TRUE setara dengan memanggil WdfPreDeviceInstall.
Jika penginstal menetapkan anggota ShowRebootPrompt dari struktur WDF_COINSTALLER_INSTALL_OPTIONS ke FALSE, WdfPreDeviceInstallEx tidak memberi tahu manajer PnP bahwa mulai ulang diperlukan. Sebaliknya, fungsi mengembalikan ERROR_SUCCESS_REBOOT_REQUIRED. Alat penginstal Anda dapat menentukan kapan atau apakah akan memulai ulang komputer,

Untuk informasi selengkapnya tentang fungsi dan penginstal WdfPreDeviceInstallEx untuk driver berbasis kerangka kerja perangkat non-PnP, lihat Menginstal Driver Non-PnP. Untuk informasi selengkapnya tentang CreateService, GetProcAddress, dan LoadLibrary, lihat dokumentasi Microsoft Windows SDK.

Contoh

Untuk contoh kode yang menggunakan fungsi WdfPreDeviceInstallEx , lihat alat penginstal untuk sampel NONPNP .

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1.9
Header	wdfinstaller.h (termasuk Wdfinstaller.h)
Pustaka	T/A (Diekspor oleh pustaka penginstal bersama KMDF. Untuk informasi tentang nama file pustaka penginstal bersama, lihat Menggunakan Penginstal Bersama KMDF.)

Lihat juga

WdfPostDeviceInstall

WdfPreDeviceInstall

Share via