Funzione NdisCmActivateVc (ndis.h)

Articolo
08/07/2023

NdisCmActivateVc passa i parametri di chiamata forniti da CM, inclusi i parametri multimediali, per un determinato VC fino al driver miniport sottostante.

Sintassi

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

Parametri

[in] NdisVcHandle

Specifica l'handle che identifica il VC in cui impostare i parametri di chiamata. Il gestore chiamate ha ottenuto questo handle da NdisCoCreateVc per una chiamata in ingresso o come parametro di input alla relativa funzione ProtocolCoCreateVc per una chiamata in uscita avviata dal client.

[in, out] CallParameters

Puntatore a un buffer residente allocato da CM, formattato come struttura di tipo CO_CALL_PARAMETERS, contenente tutti i parametri specifici del supporto usati dal driver miniport sottostante per l'attivazione VC.

Valore restituito

Quando NdisCmActivateVc restituisce qualsiasi elemento diverso da NDIS_STATUS_PENDING, il gestore chiamate deve effettuare una chiamata interna alla relativa Funzione ProtocolCmActivateVcComplete . In caso contrario, NDIS chiama la funzione ProtocolCmActivateVcComplete del CM al termine dell'operazione.

Commenti

NdisCmActivateVc notifica al driver miniport sottostante di configurare parametri di chiamata e supporti in un vc appena creato o per modificare quelli di un VC stabilito. NDIS inoltra i parametri di chiamata e l'handle VC specificati alla funzione MiniportCoActivateVc sottostante, che configura tutte le risorse necessarie per tenere traccia dello stato del VC e si rende pronto per i trasferimenti di dati nel VC.

Un cm autonomo chiama sempre NdisCmActivateVc dopo aver stabilito una connessione in un VC, ma prima che tutti i dati vengano inviati o ricevuti in tale VC. Per la durata della connessione, un cm può chiamare NdisCmActivateVc molte volte con la stessa NdisVcHandle come condizioni sulla modifica della rete e/o ogni volta che il client chiama NdisClModifyCallQoS. In ogni chiamata a NdisCmActivateVc, la funzione MiniportCoActivateVc sottostante del driver miniportCoActivateVc deve eseguire una delle operazioni seguenti:

Aggiornare lo stato che il driver miniport gestisce sui parametri di chiamata ai nuovi valori forniti dal gestore chiamate se il driver miniport può continuare a effettuare trasferimenti nel VC in base ai nuovi parametri di chiamata modificati.
Non eseguire la chiamata se il driver miniport non può continuare a eseguire trasferimenti in base ai vincoli dei parametri di chiamata specificati.

Quando il driver miniport sottostante ha esito negativo una richiesta per impostare o reimpostare i parametri di chiamata, il gestore chiamate potrebbe modificare la specifica originale in CallParameters e chiamare di nuovo NdisCmActivateVc . Il limite per il numero di volte in cui qualsiasi gestore chiamate tenta ripetutamente di attivare un vc dipende dall'implementazione.

Per una chiamata in uscita avviata dal client, un cm autonomo chiama in genere NdisCmActivateVc immediatamente dopo lo scambio di pacchetti che conferma un accordo negoziato con la destinazione remota della chiamata o la corretta configurazione della chiamata al commutatore, prima di notificare NDIS (e il client) del completamento della chiamata in uscita con NdisCmMakeCallComplete. Per una chiamata in ingresso, un gestore chiamate in genere NdisCmActivateVc dopo aver chiamato NdisCoCreateVc correttamente e prima di chiamare NdisCmDispatchIncomingCall.

Nel processo di configurazione di una chiamata in uscita e, mentre qualsiasi VC rimane attivato, il client può richiedere modifiche ai parametri di chiamata per tale VC, ad esempio chiamando NdisClModifyCallQos. Dopo aver verificato la validità dei parametri di chiamata specificati per qualsiasi richiesta di questo tipo, la gestione chiamate autonome deve chiamare NdisCmActivateVc per passare i parametri di chiamata modificati fino al driver miniport sottostante.

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

Requisiti

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