estrutura FILTER_VOLUME_BASIC_INFORMATION (fltuserstructures.h)

Artigo
03/01/2024

A estrutura de FILTER_VOLUME_BASIC_INFORMATION alocada pelo chamador contém informações básicas para um volume.

Sintaxe

typedef struct _FILTER_VOLUME_BASIC_INFORMATION {
  USHORT FilterVolumeNameLength;
  WCHAR  FilterVolumeName[1];
} FILTER_VOLUME_BASIC_INFORMATION, *PFILTER_VOLUME_BASIC_INFORMATION;

Membros

FilterVolumeNameLength

Comprimento somente leitura, em bytes, do nome do volume.

FilterVolumeName[1]

Nome somente leitura do volume de FilterVolumeNameLength length. Essa cadeia de caracteres Unicode não é terminada em NULL.

Comentários

Rotinas de enumeração do gerenciador de filtros, como FltEnumerateVolumeInformation, podem preencher um buffer com estruturas do tipo FILTER_VOLUME_BASIC_INFORMATION em que cada estrutura representa um volume conhecido pelo gerenciador de filtros. Essa lista de estruturas pode conter vários volumes com o mesmo nome. Para obter mais informações, consulte Noções básicas sobre enumerações de volume com nomes de volume duplicados.

A estrutura FILTER_VOLUME_BASIC_INFORMATION deve ser alinhada em um limite LONGLONG (8 bytes). Se um buffer contiver duas ou mais dessas estruturas, o valor NextEntryOffset em cada estrutura cairá em um limite de 8 bytes.

Uma estrutura FILTER_VOLUME_BASIC_INFORMATION pode ser alocada do pool paginado ou nãopagado.