Função FltCloseClientPort (fltkernel.h)

FltCloseClientPort fecha uma porta do cliente de comunicação.

Sintaxe

VOID FLTAPI FltCloseClientPort(
  [in]  PFLT_FILTER Filter,
  [out] PFLT_PORT   *ClientPort
);

Parâmetros

[in] Filter

Ponteiro de filtro opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.

[out] ClientPort

Ponteiro para uma variável que contém o identificador de porta opaco para a porta do cliente a ser fechada. No retorno, a variável recebe NULL. Esse parâmetro é necessário e não pode ser NULL na entrada.

Retornar valor

Nenhum

Comentários

Um driver de minifiltro normalmente chama FltCloseClientPort da rotina DisconnectNotifyCallback que ele registrou quando chamou FltCreateCommunicationPort. O Gerenciador de Filtros chama a rotina DisconnectNotifyCallback sempre que a contagem de identificadores do modo de usuário para a porta do cliente atinge zero ou quando o driver de minifiltro está prestes a ser descarregado.

FltCloseClientPort fecha uma porta do cliente de comunicação que foi criada pela rotina ConnectNotifyCallback do driver de minifiltro.

Na entrada, o parâmetro ClientPort é um ponteiro para uma variável que contém o identificador opaco para que a porta do cliente seja fechada. Para garantir que todas as mensagens enviadas por FltSendMessage sejam sincronizadas corretamente quando a porta do cliente de comunicação estiver sendo fechada, FltCloseClientPort define essa variável como NULL.

Essa rotina desconecta uma conexão específica do driver de minifiltro. Para fechar o identificador da porta do servidor do driver de minifiltro, que escuta conexões de entrada, use FltCloseCommunicationPort.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca Fltmgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Confira também

FilterConnectCommunicationPort

FltCloseCommunicationPort

FltCreateCommunicationPort

FltSendMessage