Macro NdisMCmRegisterSapComplete (ndis.h)
NdisMCmRegisterSapComplete restituisce lo stato finale della richiesta di un client, per cui il driver MCM
Funzione ProtocolCmRegisterSap precedentemente restituita NDIS_STATUS_PENDING, per registrare un sap.
Sintassi
void NdisMCmRegisterSapComplete(
_S_,
_H_,
_C_
);
Parametri
_S_
Specifica lo stato finale della richiesta originale del client per registrare SAP, NDIS_STATUS_SUCCESS o qualsiasi chiamante determinato NDIS_STATUS_XXX, ad eccezione di NDIS_STATUS_PENDING.
_H_
Specifica l'handle fornito da NDIS a SAP se la registrazione ha esito positivo. Il gestore chiamate ha ottenuto questo handle come parametro di input per la relativa funzione ProtocolCmRegisterSap .
_C_
Specifica l'handle in un'area del contesto residente fornita dal chiamante in cui il driver MCM mantiene lo stato per questo SAP se la registrazione ha esito positivo. In tal caso, NDIS passa nuovamente questo handle al driver MCM in tutte le chiamate successive relative a questo SAP. Se Status è impostato su un elemento diverso da NDIS_STATUS_SUCCESS, NDIS ignora questo parametro.
Valore restituito
nessuno
Osservazioni
Un driver MCM deve chiamare NdisMCmRegisterSapComplete se la relativa funzione ProtocolCmRegisterSap ha restituito NDIS_STATUS_PENDING quando è stata chiamata con l'oggetto NdisSapHandle specificato. La chiamata a NdisMCmRegisterSapComplete fa sì che NDIS chiami il client Funzione ProtocolClRegisterSapComplete .
Se il driver MCM imposta Stato su qualsiasi elemento diverso da NDIS_STATUS_SUCCESS, deve considerare l'errore NdisSapHandle quando NdisMCmRegisterSapCompleterestituisce il controllo. Dopo aver superato una registrazione SAP, il cm può rilasciare o riutilizzare l'area di contesto per SAP, se presente, già allocata. NDIS rilascia anche il relativo contesto per SAP se il driver MCM ha esito negativo nella registrazione.
Solo i driver miniport orientati alla connessione che forniscono supporto integrato per la gestione delle chiamate possono chiamare NdisMCmRegisterSapComplete. I gestori di chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCmRegisterSapComplete .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMCmRegisterSapComplete (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMCmRegisterSapComplete (NDIS 5.1) in Windows XP. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ndis.h (includere Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_MCM_Function(ndis) |