Funzione NdisCmDispatchIncomingCallQoSChange (ndis.h)
NdisCmDispatchIncomingCallQoSChange notifica a un client che una richiesta di modificare la qualità del servizio nella connessione attiva del client è stata ricevuta in rete.
Sintassi
void NdisCmDispatchIncomingCallQoSChange(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parametri
[in] NdisVcHandle
Specifica l'handle del vc 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 per la 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 autonomo chiama NdisCmDispatchIncomingCallQoSChange per notificare al client che ha ricevuto una richiesta di modifica del QoS in una connessione attiva. Tale cm supporta modifiche QoS dinamiche nelle chiamate attive, che è una funzionalità come QoS stessa che dipende dal protocollo di segnalazione.
Quando il cm stesso riceve una richiesta di modifica QoS, il gestore chiamate passa i parametri di chiamata modificati in modo appropriato per 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, 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, ad eccezione dell'eventuale aggiornamento di qualsiasi stato gestito sul QoS per il vcoS e la restituzione del controllo. In caso contrario, il client rifiuta la modifica QoS proposta rimuovendo la chiamata.
Solo i gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmDispatchIncomingCallQoSChange. Driver miniport orientati alla connessione che forniscono una chiamata integrata di gestione delle chiamate NdisMCmDispatchIncomingCallQoSChange.