Macro NdisMCmOpenAddressFamilyComplete (ndis.h)

NdisMCmOpenAddressFamilyComplete restituisce lo stato finale della richiesta di un client, per cui la funzione ProtocolCmOpenAf del driver MCM ha restituito NDIS_STATUS_PENDING, per aprire la famiglia di indirizzi del driver MCM.

Sintassi

void NdisMCmOpenAddressFamilyComplete(
   _S_,
   _H_,
   _C_
);

Parametri

_S_

Specifica lo stato finale della richiesta del client per aprire l'AF, NDIS_STATUS_SUCCESS o qualsiasi chiamante determinato NDIS_STATUS_ XXX tranne NDIS_STATUS_PENDING.

_H_

Specifica l'handle fornito da NDIS che è stato immesso nella funzione ProtocolCmOpenAf del driver MCM, che ha restituito NDIS_STATUS_PENDING.

_C_

Specifica l'handle per un'area del contesto residente allocata dal chiamante, in cui il driver MCM mantiene lo stato relativo all'apertura del client della famiglia di indirizzi, incluso NdisAfHandle, se l'apertura ha avuto esito positivo. In caso contrario, NDIS ignora questo parametro.

Valore restituito

nessuno

Osservazioni

Un driver MCM deve chiamare NdisMCmOpenAddressFamilyComplete se la funzione ProtocolCmOpenAf precedentemente restituita NDIS_STATUS_PENDING per l'oggetto NdisAfHandle specificato. Il client, che ha avviato l'operazione open-AF con penna con una chiamata a NdisClOpenAddressFamilyEx, non può eseguire ulteriori operazioni orientate alla connessione sulla stessa associazione finché NdisMCmOpenAddressFamilyComplete provoca una chiamata al client Funzione ProtocolClOpenAfCompleteEx .

Se il chiamante di NdisMCmOpenAddressFamilyComplete imposta Status su NDIS_STATUS_SUCCESS, NDIS passa successivamente l'handle CallMgrAfContext specificato come parametro di input a tutte le funzioni ProtocolCmXxx e ProtocolCoXxx fornite dal driver MCM che riguardano l'apertura della famiglia di indirizzi del client fino a quando il client non chiude l'AF. Il driver MCM deve rilasciare o riutilizzare qualsiasi area di contesto AF allocata prima di passare uno stato di errore a NdisMCmOpenAddressFamilyComplete.

Per un'apertura corretta, NdisAfHandle fornito da NDIS rappresenta un'associazione tra il driver MCM e il client per l'af aperto. Entrambi i driver NDIS devono considerare NdisAfHandle come variabile opaca da passare, non modificata e non interpretata, nelle chiamate successive alle funzioni NdisCl/Co/MCm/MCoXxx per cui questo handle è un parametro obbligatorio. Per un'apertura non riuscita, il driver MCM deve considerare NdisAfHandle non valido quando NdisMCmOpenAddressFamilyComplete restituisce il controllo .

Solo i driver miniport orientati alla connessione che forniscono supporto integrato per la gestione delle chiamate possono chiamare NdisMCmOpenAddressFamilyComplete. I gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCmOpenAddressFamilyComplete .

Requisiti

Vedi anche

NdisClOpenAddressFamilyEx

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf