Fungsi WdfPreDeviceRemove (wdfinstaller.h)
[Berlaku untuk KMDF saja]
Fungsi WdfPreDeviceRemove co-installer melakukan operasi apa pun yang mungkin diperlukan penginstal bersama sebelum penginstal driver non-Plug and Play (PnP) menghapus layanan mode kernel driver.
Sintaks
ULONG WdfPreDeviceRemove(
[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 NULL, penginstal bersama menggunakan WdfSection untuk nama tersebut.
Nilai kembali
WdfPreDeviceRemove mengembalikan ERROR_SUCCESS jika operasi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai ERROR_XXX tambahan yang ditentukan dalam Winerror.h.
Keterangan
Alat penginstal untuk driver berbasis kerangka kerja perangkat non-PnP harus memanggil WdfPreDeviceRemove sebelum alat penginstal memanggil DeleteService.
Untuk mendapatkan alamat fungsi WdfPreDeviceRemove co-installer, alat penginstal harus memanggil GetProcAddress setelah alat penginstal memanggil LoadLibrary untuk memuat penginstal bersama.
Untuk informasi selengkapnya tentang fungsi dan alat penginstal WdfPreDeviceRemove untuk driver berbasis kerangka kerja perangkat non-PnP, lihat Menginstal Driver Non-PnP. Untuk informasi selengkapnya tentang DeleteService, GetProcAddress, dan LoadLibrary, lihat dokumentasi Microsoft Windows SDK.
Contoh
Untuk contoh kode yang menggunakan fungsi WdfPreDeviceRemove , lihat alat penginstal untuk sampel NONPNP .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Header | wdfinstaller.h (termasuk Wdfinstaller.h) |
| Pustaka | N/A (Diekspor oleh pustaka penginstal bersama KMDF. Untuk informasi tentang nama file pustaka penginstal bersama, lihat Menggunakan Penginstal Bersama KMDF.) |