Funzione NdisCmOpenAddressFamilyComplete (ndis.h)
NdisCmOpenAddressFamilyComplete restituisce lo stato finale di una richiesta open-AF autonoma di un determinato af per un determinato client dopo che il chiamante ha restituito NDIS_STATUS_PENDING in risposta alla richiesta open-AF originale del client.
Sintassi
void NdisCmOpenAddressFamilyComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisAfHandle,
[in] NDIS_HANDLE CallMgrAfContext
);
Parametri
[in] Status
Specifica lo stato finale dell'operazione open-AF, NDIS_STATUS_SUCCESS o qualsiasi errore determinato da CM NDIS_STATUS_ XXX tranne NDIS_STATUS_PENDING.
[in] NdisAfHandle
Specifica l'handle fornito da NDIS che è stato immesso nella funzione ProtocolCmOpenAf di Gestione chiamate, che ha restituito NDIS_STATUS_PENDING.
[in] CallMgrAfContext
Specifica l'handle in un'area di contesto residente allocata dal chiamante in cui il gestore chiamate mantiene lo stato relativo all'apertura del client della famiglia di indirizzi, incluso NdisAfHandle, se l'apertura ha avuto esito positivo. Se lo stato non è NDIS_STATUS_SUCCESS, NDIS ignora questo parametro.
Valore restituito
nessuno
Osservazioni
Un gestore chiamate autonomo deve chiamare NdisCmOpenAddressFamilyComplete se la relativa funzione ProtocolCmOpenAf restituita in precedenza 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 sullo stesso binding fino a quando NdisCmOpenAddressFamilyComplete causa una chiamata a tale client Funzione ProtocolClOpenAfCompleteEx .
Se il chiamante di NdisCmOpenAddressFamilyComplete imposta Stato su NDIS_STATUS_SUCCESS, NDIS passa successivamente l'handle CallMgrAfContext specificato come parametro di input a tutte le funzioni ProtocolCmXxx e ProtocolCoXxx fornite da CM che interessano l'apertura del client della famiglia di indirizzi fino alla chiusura dell'AF del client. Il gestore chiamate deve rilasciare o riutilizzare qualsiasi area di contesto af allocata prima di passare uno stato di errore a NdisCmOpenAddressFamilyComplete.
Per un'apertura completata, l'NDIS fornito da NdisAfHandle rappresenta un'associazione tra il gestore chiamate e il client per l'af aperto in un determinato driver miniport a cui è associato il gestore chiamate e il client. Entrambi i driver di protocollo devono considerare NdisAfHandle come variabile opaca da passare, non modificata e non interpretata, nelle chiamate successive alle funzioni NdisCl/Cm/CoXxx per cui questo handle è un parametro obbligatorio. Per un'apertura non riuscita, il gestore chiamate deve considerare il controllo NdisAfHandle non valido quando NdisMCmOpenAddressFamilyComplete restituisce il controllo.
Solo i gestori di chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmOpenAddressFamilyComplete. I driver miniport orientati alla connessione che forniscono supporto integrato per la gestione delle chiamate devono chiamare NdisMCmOpenAddressFamilyComplete .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCmOpenAddressFamilyComplete (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCmOpenAddressFamilyComplete (NDIS 5.1) in Windows XP. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ndis.h (includere Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_CallManager_Function(ndis) |