Fungsi NdisIMCancelInitializeDeviceInstance (ndis.h)
Fungsi NdisIMCancelInitializeDeviceInstance membatalkan panggilan sebelumnya ke Fungsi NdisIMInitializeDeviceInstanceEx .
Sintaks
NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
[in] NDIS_HANDLE DriverHandle,
[in] PNDIS_STRING DeviceInstance
);
Parameter
[in] DriverHandle
Driver miniport menangani bahwa Fungsi NdisMRegisterMiniportDriver dikembalikan pada parameter NdisMiniportDriverHandle .
[in] DeviceInstance
Penunjuk ke jenis NDIS_STRING yang menjelaskan string terhitung yang diinisialisasi penelepon dalam kumpulan karakter default sistem. String berisi nama kunci registri tempat driver menyimpan informasi tentang miniport virtual dan, mungkin, informasi khusus pengikatan. Untuk driver Microsoft Windows 2000 dan yang lebih baru, string ini berisi karakter Unicode. Artinya, untuk Windows 2000 dan yang lebih baru, NDIS mendefinisikan jenis NDIS_STRING sebagai jenis UNICODE_STRING .
Nilai kembali
NdisIMCancelInitializeDeviceInstance mengembalikan NDIS_STATUS_SUCCESS jika membatalkan panggilan sebelumnya ke NdisIMInitializeDeviceInstanceEx. Jika tidak, ia mengembalikan NDIS_STATUS_FAILURE jika tidak ada cara untuk menghentikan operasi inisialisasi untuk miniport virtual.
Keterangan
Driver perantara memanggil Fungsi NdisIMInitializeDeviceInstanceEx untuk memulai operasi inisialisasi untuk miniport virtual. Sebelum NDIS memanggil fungsi MiniportInitializeEx driver, driver dapat memanggil NdisIMCancelInitializeDeviceInstance untuk membatalkan operasi inisialisasi. Misalnya, jika driver yang mendasar yang diperlukan driver perantara untuk operasi normal dihapus, driver perantara dapat membatalkan inisialisasi untuk miniport virtual apa pun yang terkait dengan driver yang dihapus.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) di Windows XP. |
| Target Platform | Desktop |
| Header | ndis.h (termasuk Ndis.h) |
| Pustaka | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Aturan kepatuhan DDI | Irql_IM_Function(ndis) |