Macro NdisMCmDispatchIncomingCallQoSChange (ndis.h)

2025-02-07

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

Sintaxis

void NdisMCmDispatchIncomingCallQoSChange(
   _H_,
   _P_
);

Parámetros

_H_

Especifica el identificador de la vc para la que se solicita el cambio en QoS. El controlador MCM obtuvo este identificador cuando llamó a NdisMCmCreateVc para configurar esta conexión para una llamada entrante o como parámetro de entrada a su función ProtocolCoCreateVc.

_P_

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

Ninguno

Observaciones

Un controlador MCM llama a NdisMCmDispatchIncomingCallQoSChange para notificar al cliente que ha recibido una solicitud para modificar el QoS en una conexión activa. Este tipo de controlador MCM admite cambios de QoS dinámicos en llamadas activas, que es una característica como QoS en sí que depende del protocolo de señalización.

El controlador MCM debe llamar a NdisMCmActivateVc siempre que realice cambios en los parámetros de llamada para un VC activo.

Una llamada a NdisMCmDispatchIncomingCallQoSChange 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 el VC y devolver el control. De lo contrario, el cliente rechaza el cambio de QoS propuesto al anular la llamada.

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMCmDispatchIncomingCallQoSChange (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisMCmDispatchIncomingCallQoSChange (NDIS 5.1)) en Windows XP.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	Irql_MCM_Function(ndis)