Función FilterGetMessage (fltuser.h)

Artículo
08/23/2023

La función FilterGetMessage obtiene un mensaje de un minifiltro en modo kernel.

Sintaxis

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

Parámetros

[in] hPort

Identificador de puerto de comunicación devuelto por una llamada anterior a FilterConnectCommunicationPort. Este parámetro es obligatorio y no puede ser NULL.

[out] lpMessageBuffer

Puntero a un búfer asignado por el autor de la llamada que recibe el mensaje del minifiltro. El mensaje debe contener una estructura FILTER_MESSAGE_HEADER , pero de lo contrario, su formato es definido por el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.

[in] dwMessageBufferSize

Tamaño, en bytes, del búfer al que apunta el parámetro lpMessageBuffer .

[in, out] lpOverlapped

Puntero a una estructura SUPERPUESTA. Este parámetro es opcional y puede ser NULL. Si no es NULL, el autor de la llamada debe inicializar el miembro hEvent de la estructura SUPERPUESTA a un identificador de evento válido o NULL.

Valor devuelto

FilterGetMessage devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error.

Comentarios

La función FilterGetMessage está diseñada para la operación sincrónica y asincrónica (superpuesta).

Cuando lpOverlapped es NULL y hay un mensaje disponible, FilterGetMessage devuelve inmediatamente. De lo contrario, el autor de la llamada se coloca en un estado de espera hasta que se recibe un mensaje.

Si lpOverlapped no es NULL, FilterGetMessage devuelve ERROR_IO_PENDING. En esta situación, el objeto de evento de la estructura lpOverlapped se establece en el estado no asignado antes de que FilterGetMessage devuelva. Cuando se entrega el mensaje, este evento se establece en el estado señalado.

Después de recibir el mensaje del minifiltro, el autor de la llamada puede enviar una respuesta llamando a FilterReplyMessage.

Un minifiltro o instancia envía un mensaje a una aplicación en modo de usuario llamando a FltSendMessage.