Fungsi NdisMCmRegisterAddressFamilyEx (ndis.h)

Artikel
03/01/2024

Fungsi NdisMCmRegisterAddressFamilyEx mendaftarkan keluarga alamat (AF) untuk komunikasi antara manajer panggilan miniport (MCM) dan klien CoNDIS.

Sintaks

NDIS_STATUS NdisMCmRegisterAddressFamilyEx(
  [in] NDIS_HANDLE        MiniportAdapterHandle,
  [in] PCO_ADDRESS_FAMILY AddressFamily
);

Parameter

[in] MiniportAdapterHandle

Handel yang disediakan NDIS yang mengidentifikasi adaptor miniport. Handel ini adalah parameter input ke MCM Fungsi MiniportInitializeEx .

[in] AddressFamily

Penunjuk ke struktur CO_ADDRESS_FAMILY yang mengidentifikasi AF yang didukung driver MCM.

Penunjuk menjadi parameter input ke ProtocolCoAfRegisterNotify berfungsi dari semua klien CoNDIS yang terikat dengan driver MCM ini.

Nilai kembali

NdisMCmRegisterAddressFamilyEx dapat mengembalikan salah satu hal berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Driver miniport yang terdaftar di NDIS sebagai manajer panggilan untuk AF yang ditentukan parameter AddressFamily , sehingga NDIS akan memanggil Fungsi ProtocolCoAfRegisterNotify dari semua klien yang mengikat driver MCM.
NDIS_STATUS_RESOURCES	Operasi yang diminta gagal karena NDIS tidak dapat mengalokasikan memori yang cukup atau menginisialisasi informasi status yang digunakannya untuk melacak driver MCM sebagai manajer panggilan dari AF yang ditentukan.
NDIS_STATUS_FAILURE	NDIS gagal melakukan panggilan ke NdisMCmRegisterAddressFamilyEx, mungkin karena salah satu alasan berikut: Pemanggil tidak terdaftar sebagai driver miniport berorientasi koneksi. Penelepon mencoba mendaftarkan AF duplikat untuk adaptor miniport tertentu.

Keterangan

NDIS MCM, yang mendaftar sebagai driver miniport NDIS dengan Fungsi NdisMRegisterMiniportDriver , harus memanggil fungsi NdisMCmRegisterAddressFamilyEx untuk mendaftarkan AF. Manajer panggilan yang berdiri sendiri harus memanggil Fungsi NdisCmRegisterAddressFamilyEx .

Untuk mendaftarkan AF untuk adaptor miniport, MCM harus memanggil NdisMCmRegisterAddressFamilyEx dari fungsi MiniportInitializeEx .

Driver kartu antarmuka jaringan (NIC) apa pun yang memiliki dukungan sinyal berorientasi koneksi on-board dapat mendaftarkan dirinya sebagai driver MCM untuk performa yang lebih baik dalam mengelola panggilan. Jika driver mendaftar sebagai driver MCM, setiap manajer panggilan yang berdiri sendiri dengan dukungan manajemen panggilan driver NIC sendiri akan dipindahkan.

Driver MCM memanggil NdisMCmRegisterAddressFamilyEx setelah menentukan bahwa NIC beroperasi penuh dan driver dapat menyelesaikan operasi I/O jaringan. Artinya, MCM mendaftarkan dirinya sebagai manajer panggilan dan mengiklankan layanan sinyal khususnya untuk klien CoNDIS.

Setelah MiniportInitializeEx mengembalikan kontrol dengan pendaftaran yang berhasil sebagai manajer panggilan, NDIS memanggil fungsi ProtocolBindAdapterEx dari klien potensial dan, kemudian, ProtocolCoAfRegisterNotify berfungsi dari semua klien yang mengikat diri mereka ke adaptor miniport MCM terkait. Klien ini kemudian menyebabkan NDIS memanggil fungsi ProtocolCmOpenAf dari MCM.

MCM dapat mendukung lebih dari satu AF untuk satu NIC yang dikelolanya. Driver MCM harus memanggil NdisMCmRegisterAddressFamilyEx sekali untuk setiap AF yang didaftarkannya untuk adaptor miniport. Hanya satu driver MCM yang dapat mendukung jenis AF tertentu untuk klien yang terikat ke adaptor miniport tertentu.

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