estrutura FILTER_FULL_INFORMATION (fltuserstructures.h)

Artigo
02/26/2024

A estrutura FILTER_FULL_INFORMATION contém informações completas para um driver de minifiltro.

Sintaxe

typedef struct _FILTER_FULL_INFORMATION {
  ULONG  NextEntryOffset;
  ULONG  FrameID;
  ULONG  NumberOfInstances;
  USHORT FilterNameLength;
  WCHAR  FilterNameBuffer[1];
} FILTER_FULL_INFORMATION, *PFILTER_FULL_INFORMATION;

Membros

NextEntryOffset

Deslocamento de bytes da próxima entrada de FILTER_FULL_INFORMATION, se várias entradas estiverem presentes em um buffer. Esse membro será zero se nenhuma outra entrada seguir esta.

FrameID

Índice baseado em zero do quadro atual.

NumberOfInstances

Número de instâncias que existem atualmente para esse minifiltro.

FilterNameLength

Comprimento, em bytes, do nome do minifiltro.

FilterNameBuffer[1]

Especifica o primeiro caractere da cadeia de caracteres de nome do filtro. Esse caractere é seguido na memória pelo restante da cadeia de caracteres. O comprimento da cadeia de caracteres é especificado pelo membro FilterNameLength . A cadeia de caracteres é Unicode e não é terminada em NULL.

Comentários

A estrutura FILTER_FULL_INFORMATION é passada como um parâmetro para rotinas como FilterFindFirst, FilterFindNext, FilterGetInformation, FltEnumerateFilterInformation e FltGetFilterInformation.

Essa estrutura deve ser alinhada em um limite LONGLONG (8 bytes). Se um buffer contiver duas ou mais dessas estruturas, o valor NextEntryOffset em cada entrada, exceto a última, se enquadra em um limite de 8 bytes.