Funzione NdisCmRegisterSapComplete (ndis.h)
NdisCmRegisterSapComplete restituisce lo stato finale della richiesta di un client, per il quale il cm ha restituito in precedenza NDIS_STATUS_PENDING, per registrare un SAP.
Sintassi
void NdisCmRegisterSapComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisSapHandle,
[in] NDIS_HANDLE CallMgrSapContext
);
Parametri
[in] Status
Specifica lo stato finale della richiesta originale del client per registrare SAP, NDIS_STATUS_SUCCESS o qualsiasi NDIS_STATUS_XXX determinato da CM, tranne NDIS_STATUS_PENDING.
[in] NdisSapHandle
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 il relativo Funzione ProtocolCmRegisterSap .
[in] CallMgrSapContext
Specifica l'handle in un'area del contesto residente fornita dal chiamante in cui il cm mantiene lo stato per questo SAP se la registrazione ha esito positivo. In tal caso, NDIS passa nuovamente questo handle al CM 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 gestore chiamate autonomo deve chiamare NdisCmRegisterSapComplete se la relativa funzione ProtocolCmRegisterSap ha restituito NDIS_STATUS_PENDING quando è stata chiamata con l'oggetto NdisSapHandle specificato. La chiamata a NdisCmRegisterSapComplete causa la chiamata a NDIS Funzione ProtocolClRegisterSapComplete .
Se il gestore chiamate imposta Stato su qualsiasi elemento diverso da NDIS_STATUS_SUCCESS, deve considerare il valore NdisSapHandle non valido non appena chiama NdisCmRegisterSapComplete. Dopo aver superato una registrazione SAP, il cm può rilasciare o riutilizzare l'area di contesto per SAP allocata quando NdisCmRegisterSapComplete restituisce il controllo. NDIS rilascia anche il relativo contesto per SAP se il gestore chiamate non riesce la registrazione.
Solo i gestori di chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmRegisterSapComplete. Driver miniport orientati alla connessione che forniscono il supporto integrato per la gestione delle chiamate NdisMCmRegisterSapComplete.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCmRegisterSapComplete (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCmRegisterSapComplete (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) |