Funzione NdisMCmActivateVc (ndis.h)

Articolo
08/07/2023

NdisMCmActivateVc informa 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 elemento diverso da NDIS_STATUS_PENDING, il driver MCM deve effettuare una chiamata interna alla relativa Funzione ProtocolCmActivateVcComplete . In caso contrario, NDIS chiama la funzione ProtocolCmActivateVcComplete del driver MCM al termine di questa operazione.

Commenti

NdisMCmActivateVc informa NDIS che un driver MCM ha configurato parametri di chiamata e supporti in un VC appena creato o 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 di inviare o ricevere dati in tale VC. Questa chiamata notifica a NDIS che il driver miniport ha reso pronta 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 seguendo l'handshake denotando un contratto negoziato con il nodo remoto o la corretta configurazione della chiamata al commutatore, prima di notificare NDIS (e il client) del completamento della chiamata in uscita con NdisMCmMakeCallComplete. Per una chiamata in ingresso, un driver MCM chiama in genere NdisMCmActivateVc dopo aver chiamato NdisMCmCreateVc e prima di chiamarlo NdisMCmDispatchIncomingCall.

Il writer del driver determina se un driver MCM ha una funzione MiniportCoActivateVc (interna) 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 sulla modifica di rete e/o ogni volta che il client chiama NdisClModifyCallQoS. Il driver MCM deve aggiornare lo stato che gestisce sui parametri di chiamata ai nuovi valori se può continuare a eseguire trasferimenti nel vc in base ai nuovi parametri di chiamata modificati. Deve chiamare NdisMCmActivateVc per notificare a NDIS le 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 superato la richiesta del client di modificare QoS o altri parametri di chiamata per il VC in modo che il driver miniport non possa continuare a effettuare trasferimenti nel VC.
Ripristinare i parametri di chiamata in uno stato accettato in precedenza, notificare 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 VC.

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 .

Requisiti

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 (includere Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_MCM_Function(ndis)