Expand Minimize

FltIsVolumeWritable routine

The FltIsVolumeWritable routine determines whether the disk device that corresponds to a volume or minifilter driver instance is writable.

Syntax


NTSTATUS FltIsVolumeWritable(
  _In_   PVOID FltObject,
  _Out_  PBOOLEAN IsWritable
);

Parameters

FltObject [in]

An opaque pointer for the volume or instance. Be aware that the associated volume must be a local file system volume.

IsWritable [out]

A pointer to a caller-allocated Boolean variable that receives TRUE if the volume is writable; FALSE otherwise.

Return value

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

Return codeDescription
STATUS_INSUFFICIENT_RESOURCES

FltIsVolumeWritable encountered a memory allocation failure. This is an error code.

STATUS_INVALID_DEVICE_REQUEST

The disk device does not support IOCTL_DISK_IS_WRITABLE requests. This is an error code.

 

Remarks

FltIsVolumeWritable sends an IOCTL_DISK_IS_WRITABLE request to the underlying storage device that is associated with the given volume or instance.

In versions of Windows prior to Windows Vista, the FltIsVolumeWritable routine accepted only volumes, not instances.

Requirements

Version

The FltIsVolumeWritable routine is available in Windows Vista and later versions of Windows.

Header

Fltkernel.h (include Fltkernel.h)

Library

Fltmgr.lib

IRQL

PASSIVE_LEVEL

See also

IOCTL_DISK_IS_WRITABLE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.