Fungsi WdfPreDeviceInstall (wdfinstaller.h)
[Hanya berlaku untuk KMDF]
Fungsi WdfPreDeviceInstall co-installer melakukan operasi apa pun yang mungkin diperlukan penginstal bersama sebelum penginstal driver non-Plug and Play (PnP) membuat layanan mode kernel driver.
Sintaks
ULONG WdfPreDeviceInstall(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName
);
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.
Nilai kembali
WdfPreDeviceInstall 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 WdfPreDeviceInstall co-installer, alat penginstal harus memanggil GetProcAddress setelah alat 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), WdfPreDeviceInstall menginformasikan manajer Plug and Play (PnP). Manajer PnP kemudian meminta pengguna bahwa mulai ulang diperlukan.
Untuk informasi selengkapnya tentang fungsi dan penginstal WdfPreDeviceInstall 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 WdfPreDeviceInstall , lihat alat penginstal untuk sampel NONPNP .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| 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.) |