Funzione NdisCmDeactivateVc (ndis.h)

Articolo
02/26/2024

NdisCmDeactivateVc notifica a NDIS e al driver miniport sottostante che non ci saranno ulteriori trasferimenti in un determinato vc attivo.

Sintassi

NDIS_STATUS NdisCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parametri

[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 ha configurato vc per una chiamata in uscita avviata dal client.

Valore restituito

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 di CM al termine dell'operazione.

Commenti

Un gestore chiamate autonomo chiama NdisCmDeactivateVc come passaggio essenziale per chiudere una chiamata, in genere dopo lo scambio di pacchetti con componenti di rete che eliminano la chiamata.

Una chiamata a NdisCmDeactivateVc fa sì che NDIS chiami la funzione MiniportCoDeactivateVc del driver miniport sottostante , 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.

NdisVcHandle passato a NdisCmDeactivateVc rimane valido dopo il completamento della disattivazione di VC. La disattivazione di qualsiasi VC consente al suo creatore di reinizializzare il vc per il riutilizzo:

Dopo la disattivazione vc e la chiusura della chiamata, un client può riutilizzare un vc creato in origine 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 arrivo allo stesso client con NdisCmDispatchIncomingCall.

L'autore di un determinato vc che non verrà riutilizzato chiama NdisCoDeleteVc per distruggere tale vc.

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 il supporto integrato per la gestione delle chiamate NdisMCmDeactivateVc .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCmDeactivateVc (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCmDeactivateVc (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_CallManager_Function(ndis)