Funzione FilterGetMessage (fltuser.h)

Articolo
08/23/2023

La funzione FilterGetMessage ottiene un messaggio da un minifilter in modalità kernel.

Sintassi

HRESULT FilterGetMessage(
  [in]      HANDLE                 hPort,
  [out]     PFILTER_MESSAGE_HEADER lpMessageBuffer,
  [in]      DWORD                  dwMessageBufferSize,
  [in, out] LPOVERLAPPED           lpOverlapped
);

Parametri

[in] hPort

Handle di porta di comunicazione restituito da una chiamata precedente a FilterConnectCommunicationPort. Questo parametro è obbligatorio e non può essere NULL.

[out] lpMessageBuffer

Puntatore a un buffer allocato dal chiamante che riceve il messaggio dal minifilter. Il messaggio deve contenere una struttura FILTER_MESSAGE_HEADER , ma in caso contrario il formato è definito dal chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in] dwMessageBufferSize

Dimensioni, in byte, del buffer a cui punta il parametro lpMessageBuffer .

[in, out] lpOverlapped

Puntatore a una struttura OVERLAPPED. Questo parametro è facoltativo e può essere NULL. Se non è NULL, il chiamante deve inizializzare il membro hEvent della struttura OVERLAPPED in un handle di evento valido o NULL.

Valore restituito

FilterGetMessage restituisce S_OK in caso di esito positivo. In caso contrario, restituisce un valore di errore.

Commenti

La funzione FilterGetMessage è progettata sia per l'operazione sincrona che asincrona (sovrapposta).

Quando lpOverlapped è NULL e un messaggio è disponibile, FilterGetMessage restituisce immediatamente. In caso contrario, il chiamante viene inserito in uno stato di attesa fino a quando non viene ricevuto un messaggio.

Se lpOverlapped non è NULL, FilterGetMessage restituisce ERROR_IO_PENDING. In questo caso, l'oggetto evento nella struttura lpOverlapped viene impostato sullo stato non assegnato prima che FilterGetMessage restituisca. Quando il messaggio viene recapitato, questo evento viene impostato sullo stato segnalato.

Dopo aver ricevuto il messaggio dal minifilter, il chiamante può inviare una risposta chiamando FilterReplyMessage.

Un minifilter o un'istanza invia un messaggio a un'applicazione in modalità utente chiamando FltSendMessage.