Função FltCloseClientPort (fltkernel.h)

Artigo
03/01/2024

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.