Macro NdisMCmCloseCallComplete (ndis.h)
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) |