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 tranne NDIS_STATUS_PENDING.

[in] NdisVcHandle

Specifica l'handle che identifica il vc. Il chiamante ha ottenuto questo handle dal relativo stato per VC, designato dal MiniportVcContext passato come parametro di input al relativo funzione di 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 precedentemente restituita NDIS_STATUS_PENDING in risposta a una richiesta di attivazione o riattivazione del vc identificato dal 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 i trasferimenti nel vc possono essere eseguiti usando i parametri di chiamata forniti fino a quando il driver miniport non chiama NdisMCoActivateVcComplete.

Se il driver miniport rileva i parametri di chiamata forniti da CM non è accettabile, l'attivazione vc non riesce quando chiama NdisMCoActivateVcComplete. Se si verifica un errore di attivazione iniziale di un vc, il protocollo che ha creato il vco può eliminarlo. 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 dei supporti 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 originariamente ha richiesto l'attivazione vc.

Fabbisogno

Vedere anche

CO_CALL_PARAMETERS

miniportCoActivateVc

NdisCmActivateVc

NdisCmDeactivateVc