PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE função de retorno de chamada (ndis.h)

  • Artigo

A função ProtocolClIncomingCallQoSChange é usada por clientes orientados à conexão em redes que dão suporte à qualidade dinâmica do serviço. Esses clientes devem ter funções ProtocolClIncomingCallQoSChange . Caso contrário, a função ProtocolClIncomingCallQoSChange registrada de um driver de protocolo pode simplesmente retornar o controle.

Nota Você deve declarar a função usando o tipo PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE . Para obter mais informações, consulte a seção Exemplos a seguir.
 

Sintaxe

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE ProtocolClIncomingCallQosChange;

void ProtocolClIncomingCallQosChange(
  [in] NDIS_HANDLE ProtocolVcContext,
  [in] PCO_CALL_PARAMETERS CallParameters
)
{...}

Parâmetros

[in] ProtocolVcContext

Especifica o identificador para a área de contexto por VC do cliente para a VC na qual uma solicitação para modificar a qualidade do serviço veio pela rede.

[in] CallParameters

Ponteiro para um buffer, formatado como uma estrutura CO_CALL_PARAMETERS , que contém a nova especificação de QoS.

Retornar valor

Nenhum

Comentários

Uma chamada para ProtocolClIncomingCallQoSChange indica ao cliente que um par remoto solicitou uma alteração na qualidade do serviço nessa chamada. A nova qualidade de serviço é descrita em CallParameters . O cliente pode aceitar a alteração solicitada simplesmente retornando o controle . Do contrário,
ProtocolClIncomingCallQoSChange deve derrubar a chamada com NdisClCloseCall.

Exemplos

Para definir uma função ProtocolClIncomingCallQoSChange , primeiro você deve fornecer uma declaração de função que identifique o tipo de função que você está definindo. O Windows fornece um conjunto de tipos de função para drivers. Declarar uma função usando os tipos de função ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para escrever drivers para o sistema operacional Windows.

Por exemplo, para definir uma função ProtocolClIncomingCallQoSChange chamada "MyClIncomingCallQoSChange", use o tipo PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE conforme mostrado neste exemplo de código:

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE MyClIncomingCallQoSChange;

Em seguida, implemente sua função da seguinte maneira:

_Use_decl_annotations_
VOID
 MyClIncomingCallQoSChange(
    NDIS_HANDLE  ProtocolVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

O tipo de função PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE é definido no arquivo de cabeçalho Ndis.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers NDIS.

Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte ProtocolClIncomingCallQoSChange (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte ProtocolClIncomingCallQoSChange (NDIS 5.1)) no Windows XP.
Plataforma de Destino Windows
Cabeçalho ndis.h (inclua Ndis.h)
IRQL <= DISPATCH_LEVEL

Confira também

NdisClCloseCall

NdisClModifyCallQoS

ProtocolCmModifyCallQoS