Função NdisClIncomingCallComplete (ndis.h)
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) |