Funzione NdisCmRegisterAddressFamilyEx (ndis.h)

Articolo
08/07/2023

La funzione NdisCmRegisterAddressFamilyEx registra una famiglia di indirizzi (AF) per la comunicazione tra i driver CoNDIS.

Sintassi

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

Parametri

[in] NdisBindingHandle

Handle fornito dall'NDIS nel parametro NdisBindingHandle della funzione NdisOpenAdapterEx . Questo handle identifica l'associazione da associare all'af.

[in] AddressFamily

Puntatore a una struttura CO_ADDRESS_FAMILY che identifica il gestore chiamate e l'AF che supporta per l'associazione specificata da NdisBindingHandle .

Il puntatore per AddressFamily diventa un parametro di input Funzioni ProtocolCoAfRegisterNotify di tutti i client associati alla stessa scheda miniport CoNDIS.

Valore restituito

NdisCmRegisterAddressFamilyEx può restituire uno dei seguenti elementi:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Il driver del protocollo ha registrato l'AF a cui punta AddressFamily , quindi NDIS chiamerà il Funzioni ProtocolCoAfRegisterNotify di tutti i client che si associano alla stessa scheda miniport.
NDIS_STATUS_RESOURCES	L'operazione richiesta non è riuscita perché NDIS non ha potuto allocare memoria sufficiente o inizializzare lo stato usato per tenere traccia del gestore chiamate o dell'AF specificato.
NDIS_STATUS_FAILURE	NDIS non è riuscita la chiamata a NdisCmRegisterAddressFamilyEx, possibilmente per uno dei motivi seguenti: Il chiamante non è stato registrato come driver di protocollo orientato alla connessione. Il driver miniport a cui è associato il chiamante non è stato registrato come driver miniport orientato alla connessione. Un altro gestore chiamate ha già registrato l'AF specificato. L'associazione del chiamante viene chiusa.

Commenti

Gestioni chiamate autonome di NDIS, che registrano come driver di protocollo NDIS chiamando La funzione NdisRegisterProtocolDriver deve chiamare la funzione NdisCmRegisterAddressFamilyEx per registrare un af. I gestori di chiamate miniport (MCMS) devono invece chiamare il Funzione NdisMCmRegisterAddressFamilyEx .

Per registrare un af per un'associazione, il gestore chiamate autonomo deve chiamare NdisCmRegisterAddressFamilyEx dall'oggetto Funzione ProtocolBindAdapterEx .

La funzione ProtocolBindAdapterEx di un gestore chiamate autonoma stabilisce prima l'associazione al driver miniport sottostante chiamando la funzione NdisOpenAdapterEx . Ogni volta che NDIS chiama ProtocolBindAdapterEx con un altro handle nel parametro BindContext , ProtocolBindAdapterEx stabilisce un'associazione e registra un af supportato. In altre parole, un gestore chiamate autonomo registra infine un af per ogni associazione in cui fornisce servizi di gestione chiamate ai client orientati alla connessione.

Il gestore chiamate può supportare più di un AF e può supportare più di un af per un'unica associazione. Tuttavia, solo un gestore chiamate può supportare un determinato AF per i client associati a una determinata scheda miniport.

Quando la funzione ProtocolBindAdapterEx di un gestore chiamate restituisce il controllo dopo un'operazione di associazione riuscita, NDIS chiama l'oggetto Funzioni ProtocolCoAfRegisterNotify di tutti i client associati alla stessa 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_CallManager_Function(ndis)