Funzione NdisMCmDeactivateVc (ndis.h)

Articolo
03/08/2023

NdisMCmDeactivateVc notifica a NDIS che non ci saranno ulteriori trasferimenti in un determinato vc attivo.

Sintassi

NDIS_STATUS NdisMCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parametri

[in] NdisVcHandle

Specifica l'handle che identifica il vc. Questo handle è stato fornito da NDIS al driver MCM quando ha chiamato NdisMCmCreateVc per una chiamata in ingresso o quando la relativa funzione ProtocolCoCreateVc ha configurato vc per una chiamata in uscita avviata dal client.

Valore restituito

NdisMCmDeactivateVc può restituire uno dei seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	NDIS ha contrassegnato vc come inattivo.
NDIS_STATUS_NOT_ACCEPTED	Il vc è già disattivato, quindi questa chiamata è ridondante.

Commenti

Un driver MCM chiama NdisMCmDeactivateVc come passaggio essenziale per chiudere una chiamata, in genere dopo lo scambio di pacchetti con componenti di rete che eliminano la connessione.

Una chiamata riuscita a NdisMCmDeactivateVc consente al driver MCM di eliminare i parametri di chiamata correnti per i trasferimenti nel vc, eventualmente reinizializzandoli ai valori predefiniti determinati dal driver miniport. Tuttavia, se il vc viene riattivato successivamente per un'altra chiamata, il client fornirà nuovi parametri di chiamata al driver miniport.

NdisVcHandle passato a NdisMCmDeactivateVc rimane valido al termine della disattivazione di VC. La disattivazione di qualsiasi VC consente al suo creatore di reinizializzare il vc per riutilizzarlo o distruggerlo:

Dopo la disattivazione di VC e la chiusura della chiamata, un client può riutilizzare un vc creato in origine per effettuare un'altra chiamata con NdisClMakeCall oppure Chiamare NdisCoDeleteVc, causando così una chiamata alla funzione ProtocolCoDeleteVc del driver MCM.
Dopo la disattivazione vc e la chiusura della chiamata, un driver MCM può riutilizzare un vc creato originariamente per indicare un'altra chiamata in arrivo allo stesso client con NdisMCmDispatchIncomingCall oppure può chiamare NdisMCmDeleteVc.

Il writer di driver determina se un driver MCM dispone di una funzione MiniportCoDeactivateVc (interna) che il driver chiama nel contesto della disinstallazione delle connessioni per le chiamate in uscita e in ingresso.

Solo i driver miniport orientati alla connessione che forniscono supporto integrato per la gestione delle chiamate possono chiamare NdisMCmDeactivateVc. I gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCmDeactivateVc .

Requisiti

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