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 que a porta do cliente seja fechada. No retorno, a variável recebe NULL. Esse parâmetro é necessário e não pode ser NULL na entrada.
Valor de retorno
Nenhum
Observações
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 atingir zero ou quando o driver de minifiltro estiver prestes a ser descarregado.
FltCloseClientPort fecha uma porta do cliente de comunicação criada pela rotina de 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 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 |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | Fltmgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |