Fungsi NdisCloseAdapterEx (ndis.h)

  • Artikel

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
NDIS_STATUS_SUCCESS
 NdisCloseAdapterEx berhasil menutup pengikatan ke adaptor miniport yang mendasar.
NDIS_STATUS_PENDING
 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)

Lihat juga

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx