estrutura INSTANCE_FULL_INFORMATION (fltuserstructures.h)

Artigo
02/29/2024

A estrutura INSTANCE_FULL_INFORMATION contém informações completas para uma instância de minifiltro.

Sintaxe

typedef struct _INSTANCE_FULL_INFORMATION {
  ULONG  NextEntryOffset;
  USHORT InstanceNameLength;
  USHORT InstanceNameBufferOffset;
  USHORT AltitudeLength;
  USHORT AltitudeBufferOffset;
  USHORT VolumeNameLength;
  USHORT VolumeNameBufferOffset;
  USHORT FilterNameLength;
  USHORT FilterNameBufferOffset;
} INSTANCE_FULL_INFORMATION, *PINSTANCE_FULL_INFORMATION;

Membros

NextEntryOffset

Um deslocamento de bytes da próxima entrada de INSTANCE_FULL_INFORMATION. Se várias entradas estiverem presentes em um buffer, a última entrada conterá um zero.

InstanceNameLength

O comprimento, em bytes, do nome da instância.

InstanceNameBufferOffset

Um deslocamento de bytes do primeiro caractere da cadeia de caracteres de nome da instância. Esse caractere é seguido na memória pelo restante da cadeia de caracteres.

AltitudeLength

O comprimento, em bytes, da cadeia de caracteres de altitude.

AltitudeBufferOffset

Um deslocamento de bytes do primeiro caractere da cadeia de caracteres de altitude. Esse caractere é seguido na memória pelo restante da cadeia de caracteres.

VolumeNameLength

O comprimento, em bytes, do nome do volume.

VolumeNameBufferOffset

Um deslocamento de bytes do primeiro caractere da cadeia de caracteres de nome do volume. Esse caractere é seguido na memória pelo restante da cadeia de caracteres (por exemplo, "\Device\HarddiskVolume1").

FilterNameLength

O comprimento, em bytes, do nome do minifiltro.

FilterNameBufferOffset

Um deslocamento de bytes do primeiro caractere da cadeia de caracteres de nome do minifiltro. Esse caractere é seguido na memória pelo restante da cadeia de caracteres.

Comentários

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.

O conteúdo de todos os buffers de cadeia de caracteres referenciados por essa estrutura é Unicode.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa estrutura está disponível a partir do Microsoft Windows 2000 SP4 com Pacote Cumulativo de Atualizações, Windows XP SP2, Microsoft Windows Server 2003 SP1 e Windows Vista ou versões posteriores de sistemas operacionais Windows,
Cabeçalho	fltuserstructures.h (incluem FltUserStructures.h, FltUser.h, FltKernel.h)