Funzione FltCloseClientPort (fltkernel.h)

  • Articolo

FltCloseClientPort chiude una porta client di comunicazione.

Sintassi

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

Parametri

[in] Filter

Puntatore di filtro opaco per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[out] ClientPort

Puntatore a una variabile che contiene l'handle di porta opaca per la porta client da chiudere. In caso contrario, la variabile riceve NULL. Questo parametro è obbligatorio e non può essere NULL nell'input.

Valore restituito

nessuno

Osservazioni

Un driver minifilter chiama normalmente FltCloseClientPort dalla routine DisconnectNotifyCallback registrata quando viene chiamato FltCreateCommunicationPort. Gestione filtri chiama la routine DisconnectNotifyCallback ogni volta che il conteggio di handle in modalità utente per la porta client raggiunge zero o quando il driver minifilter sta per essere scaricato.

FltCloseClientPort chiude una porta client di comunicazione creata dalla routine ConnectNotifyCallback del driver minifilter.

In input, il parametro ClientPort è un puntatore a una variabile contenente l'handle opaco per la porta client da chiudere. Per assicurarsi che tutti i messaggi inviati da FltSendMessage vengano sincronizzati correttamente quando la porta client di comunicazione viene chiusa, FltCloseClientPort imposta questa variabile su NULL.

Questa routine disconnette una connessione specifica dal driver minifilter. Per chiudere l'handle per la porta server del minifilter driver, in ascolto delle connessioni in ingresso, usare FltCloseCommunicationPort.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione fltkernel.h (includere Fltkernel.h)
Libreria Fltmgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Vedi anche

FilterConnectCommunicationPort

FltCloseCommunicationPort

FltCreateCommunicationPort

FltSendMessage