Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
FltSetVolumeInformation
Collapse the table of content
Expand the table of content

FltSetVolumeInformation function

FltSetVolumeInformation changes various kinds of information about the volume that the given instance is attached to.

Syntax


NTSTATUS FltSetVolumeInformation(
  _In_  PFLT_INSTANCE        Instance,
  _Out_ PIO_STATUS_BLOCK     Iosb,
  _Out_ PVOID                FsInformation,
  _In_  ULONG                Length,
  _In_  FS_INFORMATION_CLASS FsInformationClass
);

Parameters

Instance [in]

Opaque instance pointer for a minifilter driver instance that is attached to the volume.

Iosb [out]

Pointer to an IO_STATUS_BLOCK structure that receives the final completion status and information about the operation.

FsInformation [out]

Pointer to a caller-allocated buffer containing the values to be set for the volume. The structure of the information contained in the buffer is defined by the FsInformationClass parameter.

Length [in]

Size in bytes of the buffer that FsInformation points to. The caller should set this parameter according to the given FsInformationClass. For example, if the value of FsInformationClass is FileFsControlInformation, Length must be at least sizeof(FILE_FS_CONTROL_INFORMATION).

FsInformationClass [in]

Type of information to be set for the volume. One of the following.

ValueMeaning

FileFsControlInformation

Set FILE_FS_CONTROL_INFORMATION for the volume.

FileFsLabelInformation

Set FILE_FS_LABEL_INFORMATION for the volume.

FileFsObjectIdInformation

Set FILE_FS_OBJECTID_INFORMATION for the volume.

 

Return value

FltSetVolumeInformation returns STATUS_SUCCESS or an appropriate NTSTATUS value such as one of the following:

Return codeDescription
STATUS_INFO_LENGTH_MISMATCH

An invalid value was specified for Length. This is an error code.

STATUS_INSUFFICIENT_RESOURCES

FltSetVolumeInformation encountered a pool allocation failure. This is an error code.

STATUS_INVALID_INFO_CLASS

An invalid value was specified for FsInformationClass. This is an error code.

STATUS_INVALID_PARAMETER

The Instance is attached to a network volume. FltSetVolumeInformation cannot be used to set network volume information. This is an error code.

 

Remarks

To query information about a volume, call FltQueryVolumeInformation.

Requirements

Target platform

Universal

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

IRQL

PASSIVE_LEVEL

See also

FILE_FS_CONTROL_INFORMATION
FILE_FS_LABEL_INFORMATION
FILE_FS_OBJECTID_INFORMATION
FltQueryVolumeInformation

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft