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 de rede normais, 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 a VC foi criada 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 for NULL.
Retornar valor
Nenhum
Comentários
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'sA função ProtocolCmIncomingCallComplete é chamada com a aceitação do cliente e 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 com a conexão ficar inoperante, 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 chamadasEm vez disso , NdisMCmDispatchIncomingCall.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisCmDispatchIncomingCloseCall (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisCmDispatchIncomingCloseCall (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_CallManager_Function(ndis) |