Função NdisCmCloseCallComplete (ndis.h)

Artigo
08/07/2023

NdisCmCloseCallComplete retorna a status final da solicitação de um cliente, para a qual o gerenciador de chamadas retornou anteriormente NDIS_STATUS_PENDING, para derrubar uma chamada.

Sintaxe

void NdisCmCloseCallComplete(
  [in]           NDIS_STATUS Status,
  [in]           NDIS_HANDLE NdisVcHandle,
  [in, optional] NDIS_HANDLE NdisPartyHandle
);

Parâmetros

[in] Status

Especifica o status final da solicitação do cliente de que o CM feche a conexão, seja NDIS_STATUS_SUCCESS ou qualquer NDIS_STATUS_XXX determinado por CM, exceto NDIS_STATUS_PENDING.

[in] NdisVcHandle

Especifica o identificador para a VC para a chamada. Esse identificador foi fornecido pelo NDIS quando a VC foi criada originalmente, seja pelo gerenciador de chamadas ou pelo cliente, com NdisCoCreateVc. Mais recentemente, o gerenciador de chamadas obteve esse identificador de seu estado por VC designado pelo CallMgrVcContext passado como um parâmetro de entrada para seu Função ProtocolCmCloseCall .

[in, optional] NdisPartyHandle

Especifica NULL se o NdisVcHandle representa uma VC ponto a ponto ou o identificador para a última parte restante em uma conexão de vários pontos, que o CM obteve de seu estado por parte designado pelo CallMgrPartyContext passado como um parâmetro de entrada para sua função ProtocolCmCloseCall .

Retornar valor

Nenhum

Comentários

Se a função ProtocolCmCloseCall de um gerenciador de chamadas autônomo retornar NDIS_STATUS_PENDING, o CM deverá chamar NdisCmCloseCallComplete posteriormente para notificar o cliente e o NDIS de que sua tentativa de interromper a conexão foi concluída, seja com êxito ou com um erro. Uma chamada para NdisCmCloseCallComplete faz com que o NDIS chame o cliente Função ProtocolClCloseCallComplete .

Se ele passar NDIS_STATUS_SUCCESS como o Status, o gerenciador de chamadas deverá considerar o NdisVcHandle (e NdisPartyHandle, se houver) inutilizável para transferências pela rede assim que chamar NdisCmCloseCallComplete. Se o gerenciador de chamadas tiver criado originalmente a VC, ele deverá chamar NdisCoDeleteVc com o mesmo NdisVcHandle que acabou de passar para NdisCmCloseCallComplete. Se o cliente criou essa VC, o gerenciador de chamadas poderá esperar uma chamada para sua função ProtocolCoDeleteVc com o
ProtocolVcContext, em que ele tem o mesmo NdisVcHandle, como um parâmetro de entrada.

Somente os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmCloseCallComplete. Drivers de miniporto orientados para conexão que fornecem suporte integrado ao gerenciamento de chamadas chamam NdisMCmCloseCallComplete .

Requisitos

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