Funzione NdisMCmRegisterAddressFamilyEx (ndis.h)

Articolo
08/07/2023

La funzione NdisMCmRegisterAddressFamilyEx registra una famiglia di indirizzi (AF) per la comunicazione tra un gestore chiamate miniport (MCM) e i client CoNDIS.

Sintassi

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

Parametri

[in] MiniportAdapterHandle

Handle fornito da NDIS che identifica un adattatore miniport. Questo handle è un parametro di input per il MCM Funzione MiniportInitializeEx .

[in] AddressFamily

Puntatore a una struttura CO_ADDRESS_FAMILY che identifica l'AF supportato dal driver MCM.

Il puntatore diventa un parametro di input per l'oggetto Funzioni ProtocolCoAfRegisterNotify di tutti i client CoNDIS associati a questo driver MCM.

Valore restituito

NdisMCmRegisterAddressFamilyEx può restituire uno dei seguenti elementi:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Il driver miniport registrato con NDIS come gestore chiamate per l'AF specificato dal parametro AddressFamily , quindi NDIS chiamerà il Funzioni ProtocolCoAfRegisterNotify di tutti i client che si associano al driver MCM.
NDIS_STATUS_RESOURCES	L'operazione richiesta non è riuscita perché NDIS non ha potuto allocare memoria sufficiente o inizializzare le informazioni sullo stato usate per tenere traccia del driver MCM come gestore chiamate dell'AF specificato.
NDIS_STATUS_FAILURE	NDIS non è riuscita la chiamata a NdisMCmRegisterAddressFamilyEx, possibilmente per uno dei motivi seguenti: Il chiamante non è stato registrato come driver miniport orientato alla connessione. Il chiamante ha provato a registrare un AF duplicato per una determinata scheda miniport.

Commenti

NDIS MCMs, che registrano come driver miniport NDIS chiamando il La funzione NdisMRegisterMiniportDriver deve chiamare la funzione NdisMCmRegisterAddressFamilyEx per registrare un af. I responsabili delle chiamate autonome devono invece chiamare Funzione NdisCmRegisterAddressFamilyEx .

Per registrare un af per una scheda miniport, mcm deve chiamare NdisMCmRegisterAddressFamilyEx dalla funzione MiniportInitializeEx .

Il driver di qualsiasi scheda di interfaccia di rete (NIC) con supporto di segnalazione orientata alla connessione a bordo può registrarsi come driver MCM per migliorare le prestazioni nella gestione delle chiamate. Se un driver registra come driver MCM, qualsiasi gestore chiamate autonomo con il supporto di gestione chiamate della scheda di interfaccia di rete è spostato.

Un driver MCM chiama NdisMCmRegisterAddressFamilyEx dopo aver determinato che una scheda di interfaccia di rete è completamente operativa e il driver può completare le operazioni di I/O di rete. Di conseguenza, tale MCM si registra come gestore chiamate e annuncia i suoi servizi di segnalazione specifici per i client CoNDIS.

Dopo MiniportInitializeEx restituisce il controllo con una registrazione riuscita come gestore chiamate, NDIS chiama le funzioni ProtocolBindAdapterEx di potenziali client e quindi Funzioni ProtocolCoAfRegisterNotify di tutti i client che si associano alla scheda miniport MCM associata. Questi client determinano quindi che NDIS chiami la funzione ProtocolCmOpenAf dell'MCM.

Un MCM può supportare più di un af per una singola scheda di interfaccia di rete gestita. Il driver MCM deve chiamare NdisMCmRegisterAddressFamilyEx una volta per ogni AF registrato per un adattatore miniport. Solo un driver MCM può supportare un particolare tipo di AF per i client associati a una determinata scheda miniport.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_MCM_Function(ndis)