Fungsi NdisCmRegisterAddressFamilyEx (ndis.h)

Artikel
08/07/2023

Fungsi NdisCmRegisterAddressFamilyEx mendaftarkan keluarga alamat (AF) untuk komunikasi antara driver CoNDIS.

Sintaks

NDIS_STATUS NdisCmRegisterAddressFamilyEx(
  [in] NDIS_HANDLE        NdisBindingHandle,
  [in] PCO_ADDRESS_FAMILY AddressFamily
);

Parameter

[in] NdisBindingHandle

Handel yang disediakan NDIS pada parameter NdisBindingHandle dari fungsi NdisOpenAdapterEx . Handel ini mengidentifikasi pengikatan untuk dikaitkan dengan AF.

[in] AddressFamily

Penunjuk ke struktur CO_ADDRESS_FAMILY yang mengidentifikasi manajer panggilan dan AF yang didukungnya untuk pengikatan yang ditentukan NdisBindingHandle .

Penunjuk untuk AddressFamily menjadi parameter input ke Fungsi ProtocolCoAfRegisterNotify dari semua klien yang terikat ke adaptor miniport CoNDIS yang sama.

Nilai kembali

NdisCmRegisterAddressFamilyEx dapat mengembalikan salah satu hal berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Driver protokol mendaftarkan AF yang dituju AddressFamily , sehingga NDIS akan memanggil Fungsi ProtocolCoAfRegisterNotify dari semua klien yang mengikat diri mereka ke adaptor miniport yang sama.
NDIS_STATUS_RESOURCES	Operasi yang diminta gagal karena NDIS tidak dapat mengalokasikan memori yang cukup atau menginisialisasi status yang digunakannya untuk melacak manajer panggilan atau AF yang ditentukan.
NDIS_STATUS_FAILURE	NDIS gagal melakukan panggilan ke NdisCmRegisterAddressFamilyEx, mungkin karena salah satu alasan berikut: Pemanggil tidak terdaftar sebagai driver protokol berorientasi koneksi. Driver miniport yang terikat pemanggil tidak terdaftar sebagai driver miniport berorientasi koneksi. Manajer panggilan lain telah mendaftarkan AF yang ditentukan. Pengikatan penelepon sedang ditutup.

Keterangan

Manajer panggilan mandiri NDIS, yang mendaftar sebagai driver protokol NDIS dengan memanggil Fungsi NdisRegisterProtocolDriver , harus memanggil fungsi NdisCmRegisterAddressFamilyEx untuk mendaftarkan AF. Manajer panggilan miniport (MCM) harus memanggil Fungsi NdisMCmRegisterAddressFamilyEx .

Untuk mendaftarkan AF untuk pengikatan, manajer panggilan mandiri harus memanggil NdisCmRegisterAddressFamilyEx dari Fungsi ProtocolBindAdapterEx .

Fungsi ProtocolBindAdapterEx manajer panggilan yang berdiri sendiri pertama kali menetapkan pengikatan ke driver miniport yang mendasar dengan memanggil fungsi NdisOpenAdapterEx . Setiap kali NDIS memanggil ProtocolBindAdapterEx dengan handel lain di parameter BindContext , ProtocolBindAdapterEx membuat pengikatan dan mendaftarkan AF yang didukungnya. Dengan kata lain, manajer panggilan yang berdiri sendiri akhirnya mendaftarkan AF untuk setiap pengikatan di mana ia menyediakan layanan manajemen panggilan ke klien yang berorientasi koneksi.

Manajer panggilan dapat mendukung lebih dari satu AF dan dapat mendukung lebih dari satu AF untuk satu pengikatan. Namun, hanya satu manajer panggilan yang dapat mendukung AF tertentu untuk klien yang terikat ke adaptor miniport tertentu.

Ketika fungsi ProtocolBindAdapterEx manajer panggilan mengembalikan kontrol setelah operasi pengikatan berhasil, NDIS memanggil Fungsi ProtocolCoAfRegisterNotify dari semua klien yang terikat ke adaptor miniport yang sama.

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)