PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE função de retorno de chamada (ndis.h)
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.
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 |