IOCTL_EHSTOR_DEVICE_GET_QUEUE_STATE control code

The IOCTL_EHSTOR_DEVICE_GET_QUEUE_STATE request is sent by silo drivers and applications to determine the state of a storage device queue. IO requests in the storage device queue are held when the device is temporarily unauthorized. A storage device may become temporarily unauthorized in low power states or when there is a policy that requires locking Enhanced Storage devices such as when the user session is locked.

Input Parameters

None.

Output Parameters

The output buffer at Irp->AssociatedIrp.SystemBuffer contains an ACT_QUEUE_STATE structure. ACT_QUEUE_STATE is declared in ehstorioctl.h as the following.


typedef struct tagACT_QUEUE_STATE
{
    BOOLEAN fFrozen;
} ACT_QUEUE_STATE;

fFrozen

The freeze state of the IO request queue for a storage device. If set to TRUE, the queue is frozen and all IO requests sent to the storage device are held. Otherwise, IO requests in the device queue are processed.

I/O Status Block

One of the following values can be returned in the Status field.

Status ValueDescription
STATUS_SUCCESSThe queue state was returned successfully.
STATUS_BUFFER_TOO_SMALLThe output buffer length is too small.

 

Requirements

Version

Available starting with Windows 8

Header

EhStorIoctl.h (include EhStorIoctl.h)

See also

IOCTL_EHSTOR_DEVICE_SET_QUEUE_STATE

 

 

Send comments about this topic to Microsoft

表示:
© 2014 Microsoft