Edit

FSCTL_MARK_VOLUME_DIRTY control code

  • Article

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 [in]: FltFsControlFile only. An opaque instance pointer to the minifilter driver instance that is initiating the FSCTL request.

  • FileObject [in]: FltFsControlFile only. A file pointer object specifying the volume to be marked dirty. This parameter is required and cannot be NULL.

  • FileHandle [in]: ZwFsControlFile only. A handle to the volume that is to be marked dirty. This parameter is required and cannot be NULL.

  • FsControlCode [in]: Control code for the operation. Use FSCTL_MARK_VOLUME_DIRTY for this operation.

  • InputBuffer [in]: Not used with this operation. Set to NULL.

  • InputBufferLength [in]: Not used with this operation. Set to 0.

  • OutputBuffer [out]: Not used with this operation. Set to NULL.

  • OutputBufferLength [out]: Not used with this operation. Set to 0.

Status block

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

Code Meaning
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

This code is not supported by ReFS.

Requirements

< Requirement type Requirement
Header Ntifs.h (include Ntifs.h or FltKernel.h)

See also

FltFsControlFile

FSCTL_IS_VOLUME_DIRTY

ZwFsControlFile