Funzione NdisMCmActivateVc (ndis.h)

2025-02-07

NdisMCmActivateVc notifica a NDIS che un driver MCM è pronto per effettuare trasferimenti in un determinato VC.

Sintassi

NDIS_STATUS NdisMCmActivateVc(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parametri

[in] NdisVcHandle

Specifica l'handle che identifica il vc.

[in] CallParameters

Puntatore a un buffer allocato dal chiamante, formattato come struttura di tipo CO_CALL_PARAMETERS, contenente tutti i parametri specifici del supporto usati dal driver miniport per il vc attivato.

Valore restituito

Quando NdisMCmActivateVc restituisce qualsiasi valore diverso da NDIS_STATUS_PENDING, il driver MCM deve effettuare una chiamata interna al relativo funzione ProtocolCmActivateVcComplete. In caso contrario, NDIS chiama la funzione del driver MCM ProtocolCmActivateVcComplete al termine dell'operazione.

Osservazioni

NdisMCmActivateVc informa NDIS che un driver MCM ha configurato i parametri di chiamata e supporto in un vc appena creato o ha modificato i parametri di chiamata in un vc stabilito.

Un driver MCM deve chiamare NdisMCmActivateVc dopo aver stabilito una connessione in un vc, ma prima che tutti i dati vengano inviati o ricevuti in tale vc. Questa chiamata notifica a NDIS che il driver miniport ha preparato una scheda di interfaccia di rete per i trasferimenti nel VC.

Per una chiamata in uscita avviata dal client, un driver MCM chiama in genere NdisMCmActivateVc dopo l'handshake che indica un contratto negoziato con il nodo remoto o la corretta configurazione delle chiamate al commutatore, prima di notificare NDIS (e il client) del completamento delle chiamate in uscita con NdisMCmMakeCallComplete. Per una chiamata in arrivo, un driver MCM chiama in genere NdisMCmActivateVc dopo aver chiamato NdisMCmCreateVc correttamente e prima di chiamare NdisMCmDispatchIncomingCall.

Il writer di driver determina se un driver MCM ha una funzione MiniportCoActivateVc che il driver chiama nel contesto della configurazione delle connessioni per le chiamate in uscita e in ingresso.

Per la durata della connessione, un driver MCM può modificare i parametri di chiamata come condizioni nella modifica di rete e/o ogni volta che il client chiama NdisClModifyCallQoS. Il driver MCM deve aggiornare lo stato gestito sui parametri di chiamata ai nuovi valori se può continuare a effettuare trasferimenti nel vc in base ai nuovi parametri di chiamata modificati. Deve chiamare NdisMCmActivateVc per notificare a NDIS eventuali modifiche apportate ai parametri di chiamata per il vc attivo. In caso contrario, il driver MCM può eseguire una delle operazioni seguenti:

Chiamare NdisMCmDeactivateVc dopo aver fallito la richiesta del client di modificare QoS o altri parametri di chiamata per il vc a tale stato che il driver miniport non può continuare a eseguire trasferimenti nel vc.
Ripristinare i parametri di chiamata a uno stato accettato in precedenza, inviare una notifica al client che ha richiesto la modifica e rimanere pronti per continuare a trasferire i dati nel vco. In questo caso, il client ha la possibilità di accettare i parametri di chiamata ripristinati o rifiutarli e avviare una chiusura del vco.

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

Fabbisogno

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