FSCTL_MARK_VOLUME_DIRTY control code

The FSCTL_MARK_VOLUME_DIRTY control code marks a specified volume as dirty, which triggers Autochk.exe to run on the volume during the next system restart.

To perform this operation, call FltFsControlFile or ZwFsControlFile with the following parameters.

Parameters

Instance

FltFsControlFile only. An opaque instance pointer to the minifilter driver instance that is initiating the FSCTL request.

FileObject

FltFsControlFile only. A file pointer object specifying the volume to be marked dirty. This parameter is required and cannot be NULL.

FileHandle

ZwFsControlFile only. A handle to the volume that is to be marked dirty. This parameter is required and cannot be NULL.

FsControlCode

Control code for the operation. Use FSCTL_MARK_VOLUME_DIRTY for this operation.

InputBuffer

Not used with this operation. Set to NULL.

InputBufferLength

Not used with this operation. Set to 0.

OutputBuffer

Not used with this operation. Set to NULL.

OutputBufferLength

Not used with this operation. Set to 0.

Return value

The FltFsControlFile or ZwFsControlFile routine returns STATUS_SUCCESS or an appropriate NTSTATUS value.

Return codeDescription
STATUS_INVALID_PARAMETER

The FileObject or FileHandle does not represent a valid volume handle or another parameter is invalid.

STATUS_ACCESS_DENIED

The caller does not have SE_MANAGE_VOLUME access rights.

STATUS_VOLUME_DISMOUNTED

The file system volume is dismounted.

STATUS_TOO_LATE

The file system volume is shut down.

STATUS_MEDIA_WRITE_PROTECTED

The file system volume is read-only.

 

Remarks

ReFS:  This code is not supported.

Requirements

Header

Ntifs.h (include FltKernel.h or Ntifs.h)

See also

FltFsControlFile
FSCTL_IS_VOLUME_DIRTY
ZwFsControlFile

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft