Función NdisClModifyCallQoS (ndis.h)

Artículo
02/26/2024

NdisClModifyCallQoS solicita un cambio en la calidad del servicio en una conexión.

Sintaxis

NDIS_STATUS NdisClModifyCallQoS(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parámetros

[in] NdisVcHandle

Especifica el identificador de la credencial verificable para la que el cliente desea modificar el QoS. El cliente obtuvo originalmente este identificador mediante una llamada a NdisCoCreateVc y, más recientemente, recuperó este identificador de su área de estado por VC.

[in] CallParameters

Puntero a una estructura de tipo CO_CALL_PARAMETERS que especifica el nuevo QoS solicitado por el autor de la llamada.

Valor devuelto

Cuando NdisClModifyCallQoS devuelve algo distinto de NDIS_STATUS_PENDING, el cliente debe realizar una llamada interna a su Función ProtocolClModifyCallQoSComplete . De lo contrario, NDIS llama a la función ProtocolClModifyCallQoSComplete del cliente cuando se completa esta operación.

Comentarios

Una llamada a NdisClModifyCallQoS hace que NDIS llame a la instancia de CM. ProtocolCmModifyCallQoS , que, a su vez, llama a NdisCmActivateVc para notificar al controlador de miniporte subyacente que cambie los parámetros de llamada si se puede realizar el cambio de QoS solicitado.

Si el administrador de llamadas no acepta el cambio de QoS propuesto del cliente, el cliente puede seguir usando el QoS sin cambios para la llamada o puede anular la llamada. Si el cliente y el administrador de llamadas no pueden aceptar el QoS para una llamada determinada, el creador de la credencial verificable es responsable de iniciar la desmontaje de la credencial verificable.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulta NdisClModifyCallQoS (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulta NdisClModifyCallQoS (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_Protocol_Driver_Function(ndis)