Fungsi NdisClOpenAddressFamilyEx (ndis.h)

Artikel
02/26/2024

Fungsi NdisClOpenAddressFamilyEx mendaftarkan keluarga alamat (AF) yang terkait dengan manajer panggilan untuk klien berorientasi koneksi.

Sintaks

NDIS_STATUS NdisClOpenAddressFamilyEx(
  [in]  NDIS_HANDLE        NdisBindingHandle,
  [in]  PCO_ADDRESS_FAMILY AddressFamily,
  [in]  NDIS_HANDLE        ClientAfContext,
  [out] PNDIS_HANDLE       NdisAfHandle
);

Parameter

[in] NdisBindingHandle

Handel yang dikembalikan NdisOpenAdapterEx dan yang mengidentifikasi kartu antarmuka jaringan target (NIC) atau adaptor virtual driver berikutnya yang lebih rendah yang terikat dengan pemanggil.

[in] AddressFamily

Penunjuk ke struktur CO_ADDRESS_FAMILY yang menjelaskan manajer panggilan dan AF yang akan dibuka.

Penunjuk ini adalah parameter input ke klien Fungsi ProtocolCoAfRegisterNotify , yang memanggil NdisClOpenAddressFamilyEx.

[in] ClientAfContext

Handel ke area konteks penduduk yang disediakan penelepon tempat klien mempertahankan status untuk AF ini setelah AF dibuka. NDIS meneruskan handel ini kembali ke klien dalam semua panggilan berikutnya mengenai AF ini jika panggilan ke NdisClOpenAddressFamilyEx berhasil.

[out] NdisAfHandle

Penunjuk ke variabel yang disediakan penelepon di mana NdisClOpenAddressFamilyEx mengembalikan handel yang mewakili keluarga alamat yang baru dibuka.

Nilai kembali

Ketika NdisClOpenAddressFamilyEx mengembalikan apa pun selain NDIS_STATUS_PENDING, klien harus melakukan panggilan internal ke Fungsi ProtocolClOpenAfCompleteEx . Jika tidak, NDIS memanggil fungsi ProtocolClOpenAfCompleteEx klien ketika operasi ini selesai.

Keterangan

Klien CoNDIS memanggil NdisClOpenAddressFamilyEx dari Fungsi ProtocolCoAfRegisterNotify , setelah klien memeriksa buffer input yang diarahkan oleh parameter AddressFamily untuk menentukan apakah klien mengenali manajer panggilan dan alamat terdaftar. NDIS meneruskan panggilan klien NdisClOpenAddressFamilyEx ke fungsi ProtocolCmOpenAf manajer panggilan, yang memastikan bahwa klien telah lulus dalam struktur AF yang valid.

Panggilan yang berhasil ke NdisClOpenAddressFamilyEx menyiapkan komunikasi dari klien ke manajer panggilan. Klien kemudian dapat bersiap untuk menerima panggilan masuk dengan memanggil fungsi NdisClRegisterSap . Klien juga dapat menyiapkan koneksi virtual (VC) dengan memanggil fungsi NdisCoCreateVc sehingga dapat melakukan panggilan keluar dengan memanggil fungsi NdisClMakeCall .

Jika panggilan klien ke NdisClOpenAddressFamilyEx gagal, klien harus memanggil fungsi NdisUnbindAdapter untuk meminta NDIS merilis pengikatannya ke adaptor miniport yang mendasar. Jika tidak, klien harus menyimpan handel yang dikembalikan pada parameter NdisAfHandle . Handel ini mengidentifikasi manajer panggilan tempat permintaan berikutnya mengenai keluarga alamat yang diberikan diarahkan. Klien harus memperlakukan handel yang dikembalikan ini sebagai variabel buram, meneruskannya tanpa dimodifikasi dan tidak diinterpretasikan dalam panggilan fungsi NdisXxx berikutnya.

NDIS meneruskan pointer dari parameter ClientAfContext ke fungsi ProtocolClXxx terdaftar klien di semua panggilan berikutnya yang menyangkut AF sampai klien memanggil NdisClCloseAddressFamily dengan NdisAfHandle yang sama. Setelah AF ditutup, klien dapat merilis atau menggunakan kembali penyimpanan yang dialokasikan di ClientAfContext .

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)