Função NdisCmDispatchIncomingCloseCall (ndis.h)
NdisCmDispatchIncomingCloseCall informa a um cliente para derrubar uma chamada ativa ou oferecida, geralmente porque o gerenciador de chamadas recebeu uma solicitação da rede para fechar a conexão.
Sintaxe
void NdisCmDispatchIncomingCloseCall(
[in] NDIS_STATUS CloseStatus,
[in] NDIS_HANDLE NdisVcHandle,
[in, optional] PVOID Buffer,
[in] UINT Size
);
Parâmetros
[in] CloseStatus
Especifica um NDIS_STATUS_XXX determinado por CM, indicando o motivo da solicitação de desconexão. Durante operações normais de rede, um gerenciador de chamadas passa NDIS_STATUS_SUCCESS para indicar que recebeu uma solicitação, iniciada pela parte remota, para fechar uma chamada ativa.
[in] NdisVcHandle
Especifica o identificador para a VC da chamada que está sendo desconectada. Esse identificador foi fornecido pelo NDIS quando o VC foi criado originalmente, seja pelo gerenciador de chamadas ou pelo cliente, com NdisCoCreateVc.
[in, optional] Buffer
Ponteiro para um buffer residente alocado pelo chamador que contém dados de desconexão adicionais específicos do protocolo, se houver. Dependendo do meio subjacente, esse ponteiro pode ser NULL
[in] Size
Especifica o tamanho em bytes do buffer, zero se buffer estiver NULL.
Valor de retorno
Nenhum
Observações
No curso de operações de rede normais, um CM autônomo chama NdisCmDispatchIncomingCloseCall com o CloseStatus definido como NDIS_STATUS_SUCCESS porque o cliente correspondente no nó remoto chamou NdisClCloseCall.
No entanto, um gerenciador de chamadas também pode chamar NdisCmDispatchIncomingCloseCall se ocorrer um dos seguintes procedimentos:
- O gerenciador de chamadas notificou um cliente de uma oferta de chamada de entrada. Quando o CM's função ProtocolCmIncomingCallComplete é chamada com a aceitação do cliente, valida os parâmetros de chamada de entrada, que esse cliente modificou. ProtocolCmIncomingCallComplete determina que o cliente está propondo parâmetros de chamada não compatíveis para a conexão, portanto, ele chama NdisCmDispatchIncomingCloseCall.
- Condições de rede anormais forçam o gerenciador de chamadas a derrubar chamadas ativas. Por exemplo, se o gerenciador de chamadas for notificado quando qualquer link na conexão entre esse cliente e a parte remota da conexão diminuir, o CM chamará NdisCmDispatchIncomingCloseCall para impedir que o cliente tente (ou espera) novas transferências de dados em uma conexão tão interrompida.
Uma chamada para NdisCmDispatchIncomingCloseCall faz com que o NDIS chame o cliente função ProtocolClIncomingCloseCall.
Somente os gerentes de chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmDispatchIncomingCloseCall. Drivers de miniporto orientados para conexão que fornecem chamada de suporte ao gerenciamento de chamadas NdisMCmDispatchIncomingCall.