Função NdisClModifyCallQoS (ndis.h)

Artigo
08/07/2023

NdisClModifyCallQoS solicita uma alteração na qualidade do serviço em uma conexão.

Sintaxe

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

Parâmetros

[in] NdisVcHandle

Especifica o identificador para a VC para a qual o cliente deseja modificar o QoS. O cliente originalmente obteve esse identificador chamando NdisCoCreateVc e, mais recentemente, recuperou esse identificador de sua área de estado por VC.

[in] CallParameters

Ponteiro para uma estrutura do tipo CO_CALL_PARAMETERS que especifica o novo QoS solicitado pelo chamador.

Retornar valor

Quando NdisClModifyCallQoS retorna qualquer coisa diferente de NDIS_STATUS_PENDING, o cliente deve fazer uma chamada interna para sua Função ProtocolClModifyCallQoSComplete . Caso contrário, o NDIS chamará a função ProtocolClModifyCallQoSComplete do cliente quando essa operação for concluída.

Comentários

Uma chamada para NdisClModifyCallQoS faz com que o NDIS chame os CM's Função ProtocolCmModifyCallQoS , que, por sua vez, chama NdisCmActivateVc para notificar o driver de miniporto subjacente para alterar os parâmetros de chamada se a alteração de QoS solicitada puder ser feita.

Se o gerenciador de chamadas não aceitar a alteração de QoS proposta pelo cliente, o cliente poderá continuar usando o QoS inalterado para a chamada ou poderá cancelar a chamada. Se o cliente e o gerenciador de chamadas não puderem concordar com o QoS para uma chamada específica, o criador da VC será responsável por iniciar a remoção da VC.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisClModifyCallQoS (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisClModifyCallQoS (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regras de conformidade de DDI	Irql_Protocol_Driver_Function(ndis)