Função FltSetVolumeInformation (fltkernel.h)

Artigo
02/06/2025

FltSetVolumeInformation altera vários tipos de informações sobre o volume ao qual a instância determinada está anexada.

Sintaxe

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parâmetros

[in] Instance

Ponteiro de instância opaca para uma instância de driver de minifiltro anexada ao volume.

[out] Iosb

Ponteiro para uma estrutura de IO_STATUS_BLOCK que recebe o status de conclusão final e informações sobre a operação.

[out] FsInformation

Ponteiro para um buffer alocado pelo chamador que contém os valores a serem definidos para o volume. A estrutura das informações contidas no buffer é definida pelo parâmetro FsInformationClass.

[in] Length

Tamanho em bytes do buffer que FsInformation aponta. O chamador deve definir esse parâmetro de acordo com o FsInformationClassdeterminado. Por exemplo, se o valor de FsInformationClass for FileFsControlInformation, Length deverá ser pelo menos sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Tipo de informação a ser definida para o volume. Uma das opções a seguir.

Valor	Significado
FileFsControlInformation	Defina FILE_FS_CONTROL_INFORMATION para o volume.
FileFsLabelInformation	Defina FILE_FS_LABEL_INFORMATION para o volume.
FileFsObjectIdInformation	Defina FILE_FS_OBJECTID_INFORMATION para o volume.

Valor de retorno

fltSetVolumeInformation retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_INFO_LENGTH_MISMATCH	Um valor inválido foi especificado para Length. Este é um código de erro.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation encontrou uma falha de alocação de pool. Este é um código de erro.
STATUS_INVALID_INFO_CLASS	Um valor inválido foi especificado para FsInformationClass. Este é um código de erro.
STATUS_INVALID_PARAMETER	O da Instância de é anexado a um volume de rede. FltSetVolumeInformation não pode ser usado para definir informações de volume de rede. Este é um código de erro.

Observações

Para consultar informações sobre um volume, chame FltQueryVolumeInformation.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	fltkernel.h (inclua Fltkernel.h)
biblioteca	FltMgr.lib
de DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Consulte também

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation

Partilhar via