Fungsi NdisCmNotifyCloseAddressFamily (ndis.h)

Artikel
03/01/2024

Fungsi NdisCmNotifyCloseAddressFamily memberi tahu NDIS bahwa manajer panggilan tidak mengikat dari adaptor miniport yang mendasar dan bahwa setiap klien CoNDIS terkait harus menutup keluarga alamat (AF) yang ditentukan.

Sintaks

NDIS_STATUS NdisCmNotifyCloseAddressFamily(
  [in] NDIS_HANDLE NdisAfHandle
);

Parameter

[in] NdisAfHandle

Handel NDIS yang mengidentifikasi AF yang harus ditutup NDIS. NDIS menyediakan handel ini ke fungsi ProtocolCmOpenAf manajer panggilan.

Nilai kembali

NdisCmNotifyCloseAddressFamily dapat mengembalikan salah satu hal berikut ini:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	NDIS berhasil menutup keluarga alamat.
NDIS_STATUS_PENDING	NDIS menangani permintaan ini secara asinkron, dan akan memanggil manajer panggilan Fungsi ProtocolCmNotifyCloseAfComplete ketika operasi penutupan selesai.
NDIS_STATUS_XXX	NDIS gagal dalam permintaan untuk beberapa alasan yang ditentukan NDIS atau driver klien.

Keterangan

Manajer panggilan CoNDIS yang berdiri sendiri, yang mendaftar sebagai driver protokol NDIS dengan memanggil Fungsi NdisRegisterProtocolDriver , dapat memanggil fungsi NdisCmNotifyCloseAddressFamily . Manajer panggilan miniport (MCM) sebagai gantinya memanggil Fungsi NdisMCmNotifyCloseAddressFamily .

Untuk menutup AF untuk pengikatan, manajer panggilan mandiri harus memanggil NdisCmNotifyCloseAddressFamily dari Fungsi ProtocolUnbindAdapterEx . NDIS kemudian memanggil Fungsi ProtocolClNotifyCloseAf dari klien yang membuka AF yang ditentukan.

Jika NdisCmNotifyCloseAddressFamily mengembalikan NDIS_STATUS_PENDING, NDIS akan memanggil manajer panggilan Fungsi ProtocolCmNotifyCloseAfComplete setelah klien menyelesaikan operasi penutupan AF.

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_CallManager_Function(ndis)