Funzione NdisCmDispatchIncomingCallQoSChange (ndis.h)

Articolo
08/07/2023

NdisCmDispatchIncomingCallQoSChange notifica a un client che una richiesta di modifica della qualità del servizio nella connessione attiva del client è stata ricevuta tramite la rete.

Sintassi

void NdisCmDispatchIncomingCallQoSChange(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parametri

[in] NdisVcHandle

Specifica l'handle per il quale viene richiesta la modifica in QoS. Il gestore chiamate ha originariamente ottenuto questo handle quando ha chiamato NdisCoCreateVc per configurare questa connessione per una chiamata in ingresso o come parametro di input alla relativa funzione ProtocolCoCreateVc .

[in] CallParameters

Puntatore a una struttura di tipo CO_CALL_PARAMETERS che specifica il nuovo QoS, richiesto dal client nel nodo remoto, per questa connessione.

Valore restituito

nessuno

Osservazioni

Un gestore chiamate NdisCmDispatchIncomingCallQoSChange autonomo per notificare al client che ha ricevuto una richiesta di modifica del QoS in una connessione attiva. Tale CM supporta modifiche dinamiche QoS alle chiamate attive, che è una funzionalità come QoS stessa che dipende dal protocollo di segnalazione.

Quando il CM riceve una richiesta per una modifica QoS, il gestore chiamate passa i parametri di chiamata modificati in modo appropriato a NdisCmActivateVc, quindi il driver miniport sottostante riceve anche una notifica della modifica QoS proposta. Supponendo che il driver miniport sottostante accetti i parametri di chiamata modificati, il CM chiama quindi NdisCmDispatchIncomingCallQoSChange.

Una chiamata a NdisCmDispatchIncomingCallQoSChange fa sì che NDIS chiami la funzione ProtocolClIncomingQoSChange del client. Il client accetta le modifiche proposte ai parametri di chiamata per il vc facendo nulla, tranne eventualmente aggiornando qualsiasi stato che gestisce il QoS per il controllo VC e restituito. In caso contrario, il client rifiuta la modifica QoS proposta rimuovendo la chiamata.

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

Requisiti

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