Função NdisCmCloseCallComplete (ndis.h)
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) |