Función NdisCmDispatchIncomingCallQoSChange (ndis.h)
NdisCmDispatchIncomingCallQoSChange 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 NdisCmDispatchIncomingCallQoSChange(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parámetros
[in] NdisVcHandle
Especifica el identificador de la vc 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
Ninguno
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 llamadas activas, que es una característica como QoS 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 también se notifica al controlador de miniport subyacente el cambio de QoS propuesto. Suponiendo que el controlador de miniport subyacente acepta los parámetros de llamada modificados, el 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 el VC 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 miniport orientados a la conexión que proporcionan una llamada integrada de soporte técnico de administración de llamadas NdisMCmDispatchIncomingCallQoSChange en su lugar.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) en Windows XP. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | Irql_CallManager_Function(ndis) |