Funzione NdisCmDeactivateVc (ndis.h)
NdisCmDeactivateVc notifica a NDIS e al driver miniport sottostante che non ci saranno ulteriori trasferimenti in un determinato vc attivo.
NDIS_STATUS NdisCmDeactivateVc(
[in] NDIS_HANDLE NdisVcHandle
);
[in] NdisVcHandle
Specifica l'handle che identifica il vc. Questo handle è stato fornito da NDIS al gestore chiamate quando ha chiamato NdisCoCreateVc per una chiamata in ingresso o quando la relativa funzione ProtocolCoCreateVc configurare vc per una chiamata in uscita avviata dal client.
Quando NdisCmDeactivateVc restituisce qualsiasi valore diverso da NDIS_STATUS_PENDING, il gestore chiamate deve effettuare una chiamata interna alla relativa funzione ProtocolCmDeactivateVcComplete. In caso contrario, NDIS chiama la funzione ProtocolCmDeactivateVcComplete del cms al termine dell'operazione.
Un gestore chiamate autonomo chiama NdisCmDeactivateVc come passaggio essenziale per chiudere una chiamata, in genere dopo lo scambio di pacchetti con i componenti di rete che eliminano la chiamata.
Una chiamata a NdisCmDeactivateVc fa sì che NDIS chiami il driver miniport sottostante miniportCoDeactivateVc funzione, che può eliminare i parametri di chiamata correnti per i trasferimenti nel VC, eventualmente reinizializzandoli ai valori predefiniti determinati dal driver miniport. Se il vc viene riattivato successivamente per un'altra chiamata, il client o il gestore chiamate fornirà nuovi parametri di chiamata al driver miniport.
Il NdisVcHandle passato a NdisCmDeactivateVc rimane valido al termine della disattivazione di VC. La disattivazione di qualsiasi vc consente al creatore di reinizializzare il vc per il riutilizzo:
- Dopo la disattivazione di VC e la chiusura della chiamata, un client può riutilizzare un vc creato originariamente per effettuare un'altra chiamata con NdisClMakeCall.
- Dopo la disattivazione di VC e la chiusura della chiamata, un cm può riutilizzare un vc creato originariamente per indicare un'altra chiamata in ingresso allo stesso client con NdisCmDispatchIncomingCall.
Solo i gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmDeactivateVc. Driver miniport orientati alla connessione che forniscono invece una chiamata integrata di gestione delle chiamate NdisMCmDeactivateVc.