Função NdisClIncomingCallComplete (ndis.h)

Artigo
08/07/2023

NdisClIncomingCallComplete retorna a aceitação ou rejeição de um cliente de uma chamada de entrada oferecida, para a qual a função ProtocolClIncomingCall do cliente retornou anteriormente NDIS_STATUS_PENDING.

Sintaxe

void NdisClIncomingCallComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parâmetros

[in] Status

Será definido como NDIS_STATUS_SUCCESS se o cliente aceitar a chamada oferecida. Caso contrário, esse parâmetro pode ser definido como qualquer NDIS_STATUS_XXX, exceto NDIS_STATUS_PENDING para indicar o motivo determinado pelo cliente para rejeitar a chamada.

[in] NdisVcHandle

Especifica o identificador para a VC que foi criada pelo gerenciador de chamadas para representar a chamada de entrada. O cliente obteve esse identificador do estado por VC designado pelo ProtocolVcContext passado como um parâmetro de entrada para seu Função ProtocolClIncomingCall .

[in] CallParameters

Ponteiro para uma estrutura do tipo CO_CALL_PARAMETERS, especificando os parâmetros de chamada para a chamada de entrada.

Retornar valor

Nenhum

Comentários

Se a função ProtocolClIncomingCall de um cliente retornar NDIS_STATUS_PENDING para uma chamada oferecida recebida em um SAP específico, anteriormente registrado pelo cliente com NdisClRegisterSap, o cliente deverá chamar NdisClIncomingCallComplete para indicar se está aceitando ou rejeitando a chamada oferecida.

Antes de chamar NdisClIncomingCallComplete, esse cliente pode negociar com o gerenciador de chamadas chamando NdisClModifyCallQoS uma ou mais vezes até que ambos os drivers cheguem a um acordo sobre uma qualidade de serviço aceitável para a chamada de entrada ou o cliente determine que ele deve rejeitar a chamada oferecida porque suas tentativas de modificar o QoS atingem algum limite determinado pelo cliente sem resultar em um contrato.

Se o cliente tiver alterado os parâmetros de chamada passados para sua função ProtocolClIncomingCall , ele deverá definir o membro Flags na estrutura CO_CALL_PARAMETERS com CALL_PARAMETERS_CHANGED quando passar essas alterações para NdisClIncomingCallComplete. Dependendo se o gerenciador de chamadas aceita ou rejeita as alterações propostas pelo cliente nos parâmetros de chamada, o NDIS chama posteriormente as do cliente Função ProtocolClCallConnected ou sua Função ProtocolClIncomingCloseCall , respectivamente.

Uma chamada para NdisClIncomingCallComplete faz com que o NDIS chame os CM's Função ProtocolCmIncomingCallComplete . O NDIS passa os parâmetros fornecidos pelo cliente de NdisClIncomingCallComplete como parâmetros de entrada para ProtocolCmIncomingCallComplete.

Se um cliente rejeitar uma chamada oferecida definindo Status como algo diferente de NDIS_STATUS_SUCCESS, o cliente deverá considerar o ponteiro CallParameters inválido assim que sua chamada para NdisClIncomingCallComplete ocorrer.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisClIncomingCallComplete (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisClIncomingCallComplete (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)