Macro NdisMCmCloseCallComplete (ndis.h)

Artigo
03/01/2024

NdisMCmCloseCallComplete retorna a status final da solicitação de um cliente, para a qual o driver MCM retornou anteriormente NDIS_STATUS_PENDING, para derrubar uma chamada.

Sintaxe

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

Parâmetros

_S_

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

_VH_

Especifica o identificador para a VC para a chamada. Esse identificador foi fornecido pelo NDIS quando a VC foi criada originalmente, seja pelo driver MCM com NdisMCmCreateVc ou como um parâmetro de entrada para sua função ProtocolCoCreateVc .

_PH_

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 driver MCM obteve de seu estado por parte designado pelo CallMgrPartyContext passado como um parâmetro de entrada para seu Função ProtocolCmCloseCall .

Retornar valor

Nenhum

Comentários

Se a função ProtocolCmCloseCall de um driver MCM retornar NDIS_STATUS_PENDING, ela deverá chamar NdisMCmCloseCallComplete 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 NdisMCmCloseCallComplete faz com que o NDIS chame a função ProtocolClCloseCallComplete do cliente.

Se ele passar NDIS_STATUS_SUCCESS como Status, o driver MCM deverá considerar o NdisVcHandle (e NdisPartyHandle, se houver) inutilizável para transferências pela rede assim que chamar NdisMCmCloseCallComplete. Se o driver MCM criou originalmente a VC, ele deve chamar NdisMCmDeleteVc com o mesmo NdisVcHandle que acabou de passar para NdisMCmCloseCallComplete. Se o cliente criou essa VC, o driver MCM poderá esperar uma chamada para sua função ProtocolCoDeleteVc com o
ProtocolVcContext, designando seu estado por VC no qual armazenou o mesmo NdisVcHandle, como um parâmetro de entrada.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMCmCloseCallComplete (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMCmCloseCallComplete (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL
Regras de conformidade de DDI	Irql_MCM_Function(ndis)