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 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.
Valor de retorno
Nenhum
Observações
Se a função ProtocolClIncomingCall de um cliente retornar NDIS_STATUS_PENDING para uma chamada oferecida recebida em um SAP específico, previamente registrado pelo cliente com NdisClRegisterSap, o cliente deverá chamar NdisClIncomingCallComplete para indicar se ele 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 aceitável de serviço para a chamada recebida 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 sinalizadores 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 o 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 para 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 |
|---|---|
| de cliente com suporte mínimo | 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. |
| da 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) |