Fungsi NdisCloseAdapterEx (ndis.h)
Driver protokol memanggil fungsi NdisCloseAdapterEx untuk melepaskan pengikatan dan sumber daya yang dialokasikan ketika driver yang disebut fungsi NdisOpenAdapterEx .
Sintaks
NDIS_STATUS NdisCloseAdapterEx(
[in] NDIS_HANDLE NdisBindingHandle
);
Parameter
[in] NdisBindingHandle
Handel yang disediakan NDIS pada parameter NdisBindingHandle dari NdisOpenAdapterEx. Handel ini mengidentifikasi pengikatan yang harus ditutup oleh NDIS.
Nilai kembali
NdisCloseAdapterEx mengembalikan salah satu nilai status berikut:
Menampilkan kode | Deskripsi |
---|---|
|
NdisCloseAdapterEx berhasil menutup pengikatan ke adaptor miniport yang mendasar. |
|
NdisCloseAdapterEx tidak menyelesaikan operasi penutupan dan operasi akan diselesaikan secara asinkron. NDIS memanggil driver protokol ProtocolCloseAdapterCompleteEx berfungsi ketika operasi selesai. |
Keterangan
Driver protokol biasanya memanggil NdisCloseAdapterEx dari Fungsi ProtocolUnbindAdapterEx . Driver juga dapat memanggil NdisCloseAdapterEx dari fungsi ProtocolBindAdapterEx-nya . Misalnya, jika driver gagal menetapkan nilai OID setelah disebut NdisOpenAdapterEx, driver dapat memanggil NdisCloseAdapterEx dari fungsi ProtocolBindAdapterEx-nya .
Jika driver protokol harus menutup adaptor miniport di luar konteks ProtocolUnbindAdapterEx atau ProtocolBindAdapterEx, ia harus memanggil fungsi NdisUnbindAdapter .
Driver protokol harus menunggu semua permintaan pengiriman dan permintaan OID yang berasal darinya selesai sebelum memanggil NdisCloseAdapterEx.
Segera setelah driver memanggil NdisCloseAdapterEx, handel yang diperoleh dari fungsi NdisOpenAdapterEx pada parameter NdisBindingHandle menjadi tidak valid.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Didukung di NDIS 6.0 dan yang lebih baru. |
Target Platform | Desktop |
Header | ndis.h (termasuk Ndis.h) |
Pustaka | Ndis.lib |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | Irql_Protocol_Driver_Function(ndis) |