Edit

Share via

REFS_SMR_VOLUME_GC_ACTION enumeration (ntifs.h)

  • Article

The REFS_SMR_VOLUME_GC_ACTION enum contains the available garbage collection commands for FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS.

Syntax

typedef enum _REFS_SMR_VOLUME_GC_ACTION {
  SmrGcActionStart = 1,
  SmrGcActionStartFullSpeed = 2,
  SmrGcActionPause = 3,
  SmrGcActionStop = 4
} REFS_SMR_VOLUME_GC_ACTION, *PREFS_SMR_VOLUME_GC_ACTION;

Constants

 
SmrGcActionStart
Value: 1
Specifies to start garbage collection or resume from a previously paused garbage collection. By default, garbage collection is off on Shingled Magnetic Recording (SMR) volumes. Only users with admin rights can modify this setting.
SmrGcActionStartFullSpeed
Value: 2
Specifies to start or resume garbage collection at full speed, issuing Read/Write I/O up to one SMR band size (256mb) at a time.
SmrGcActionPause
Value: 3
Specifies to temporarily stop the garbage collection if it's in progress. If the garbage collection is not in progress, there will be no operation.
SmrGcActionStop
Value: 4
Specifies to stop the garbage collection process and removes the ability to resume. If garbage collection was paused previously, this will clear the ability to resume from the point of the pause.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1709
Header ntifs.h (include Ntifs.h)

See also

FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS