Función NdisCmDispatchIncomingCallQoSChange (ndis.h)

Artículo
02/29/2024

NdisCmDispatchIncomingCallQoSChange notifica a un cliente que se ha recibido una solicitud para cambiar la calidad de servicio en la conexión activa de ese cliente a través de la red.

Sintaxis

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

Parámetros

[in] NdisVcHandle

Especifica el identificador de la credencial verificable para la que se solicita el cambio en QoS. El administrador de llamadas obtuvo originalmente este identificador cuando llamó a NdisCoCreateVc para configurar esta conexión para una llamada entrante o como parámetro de entrada a su función ProtocolCoCreateVc .

[in] CallParameters

Puntero a una estructura de tipo CO_CALL_PARAMETERS que especifica el nuevo QoS, solicitado por el cliente en el nodo remoto, para esta conexión.

Valor devuelto

None

Observaciones

Un administrador de llamadas independiente llama a NdisCmDispatchIncomingCallQoSChange para notificar al cliente que ha recibido una solicitud para modificar el QoS en una conexión activa. Este tipo de CM admite cambios dinámicos de QoS en las llamadas activas, que es una característica como QoS propiamente dicha que depende del protocolo de señalización.

Cuando el propio CM recibe una solicitud de cambio de QoS, el administrador de llamadas pasa los parámetros de llamada modificados adecuadamente a NdisCmActivateVc, por lo que el controlador de miniport subyacente también recibe una notificación del cambio de QoS propuesto. Suponiendo que el controlador de miniport subyacente acepta los parámetros de llamada modificados, cm llama a NdisCmDispatchIncomingCallQoSChange.

Una llamada a NdisCmDispatchIncomingCallQoSChange hace que NDIS llame a la función ProtocolClIncomingQoSChange del cliente. El cliente acepta las modificaciones propuestas en los parámetros de llamada para la credencial verificable sin hacer nada, excepto actualizar posiblemente cualquier estado que mantenga sobre el QoS para la credencial verificable y devolver el control. De lo contrario, el cliente rechaza el cambio de QoS propuesto al anular la llamada.

Solo los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, pueden llamar a NdisCmDispatchIncomingCallQoSChange. Los controladores de minipuerto orientados a la conexión que proporcionan compatibilidad integrada con la administración de llamadas llaman a NdisMCmDispatchIncomingCallQoSChange en su lugar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) en Windows XP.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_CallManager_Function(ndis)