Funzione NdisMCoActivateVcComplete (ndis.h)
NdisMCoActivateVcComplete notifica a NDIS e al gestore chiamate che il driver miniport ha completato l'elaborazione di una richiesta activate-VC avviata da CM, per cui il driver miniport ha restituito in precedenza NDIS_STATUS_PENDING.
Sintassi
void NdisMCoActivateVcComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parametri
[in] Status
Specifica lo stato finale dell'operazione activate-VC, che può essere NDIS_STATUS_SUCCESS o qualsiasi NDIS_STATUS_ XXX ad eccezione di NDIS_STATUS_PENDING.
[in] NdisVcHandle
Specifica l'handle che identifica il vc. Il chiamante ha ottenuto questo handle dal relativo stato per VC, designato da MiniportVcContext passato come parametro di input al relativo Funzione MiniportCoActivateVc .
[in] CallParameters
Puntatore a una struttura di tipo CO_CALL_PARAMETERS, fornita dal gestore chiamate, specificando i parametri di chiamata e supporto per l'attivazione vc.
Valore restituito
nessuno
Osservazioni
Un driver miniport orientato alla connessione deve chiamare NdisMCoActivateVcComplete se la funzione MiniportCoActivateVc restituita in precedenza NDIS_STATUS_PENDING in risposta a una richiesta di attivazione o riattivazione del vc identificato dall'oggetto NdisVcHandle specificato. Il gestore chiamate, che ha avviato l'attivazione vc con una chiamata a NdisCmActivateVc, non può notificare a NDIS o al client se è possibile effettuare trasferimenti nel vc usando i parametri di chiamata forniti fino a quando il driver miniport chiama NdisMCoActivateVcComplete.
Se il driver miniport trova inaccettabili i parametri di chiamata forniti da CM, l'attivazione vc ha esito negativo quando chiama NdisMCoActivateVcComplete. Se si verifica un errore di attivazione iniziale di un oggetto VC, il protocollo che ha creato il vc viene disattivato. Se il driver miniport non riesce una richiesta di riattivazione di un vc stabilito con nuovi parametri di chiamata, deve ripristinare i parametri di chiamata originali stabiliti per tale vc. A seconda della natura del supporto di rete, un driver miniport può modificare i parametri multimediali se i flag di arrotondamento e/o arrotondamento vengono impostati prima di chiamare NdisMCoActivateVcComplete.
Una chiamata a NdisMCoActivateVcComplete fa sì che NDIS chiami il ProtocolCmActivateVcComplete funzione del gestore chiamate che ha originariamente richiesto l'attivazione vc.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMCoActivateVcComplete (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMCoActivateVcComplete (NDIS 5.1)) in Windows XP. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ndis.h (include Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_MCO_Function(ndis) |