Edit

STOR_REQUEST_INFO_V1 structure (storport.h)

  • Article

The _STOR_REQUEST_INFO_V1 structure contains details about the storage driver IO request associated with a SCSI request block (SRB). _STOR_REQUEST_INFO_V1 is returned by the
StorPortGetRequestInfo routine.

Syntax

typedef struct _STOR_REQUEST_INFO_V1 {
  USHORT                Version;
  USHORT                Size;
  STOR_IO_PRIORITY_HINT PriorityHint;
  ULONG                 Flags;
  ULONG                 Key;
  ULONG                 Length;
  BOOLEAN               IsWriteRequest;
  UCHAR                 Reserved[3];
} STOR_REQUEST_INFO_V1, *PSTOR_REQUEST_INFO_V1;

Members

Version

The version of this structure. Set this member to STOR_REQUEST_INFO_VER_1.

Size

The size of this structure. Set this value to sizeof(STOR_REQUEST_INFO).

PriorityHint

The priority hint set for the IO request.

Value Meaning
StorIoPriorityVeryLow
0
 Very low priority.
StorIoPriorityLow
1
 Low priority.
StorIoPriorityNormal
2
 Normal priority.
StorIoPriorityHigh
3
 High priority.
StorIoPriorityCritical
4
 Critical priority.

Flags

Flags set for handling the request. May be a combination of these values:

Value Meaning
REQUEST_INFO_NO_CACHE_FLAG
 Non-cached writes are specified for this request.
REQUEST_INFO_PAGING_IO_FLAG
 Paging IO is specified for this request.
REQUEST_INFO_SEQUENTIAL_IO_FLAG
 Reads or writes are sequential.
REQUEST_INFO_TEMPORARY_FLAG
 The file for this request is temporary.
REQUEST_INFO_WRITE_THROUGH_FLAG
 No system buffering for the request.

Key

The read or write key for the request.

Length

The length of the data in this request.

IsWriteRequest

True if this is a write request. Otherwise, false, if this is a read request.

Reserved[3]

Reserved.

Remarks

The caller to StorPortGetRequestInfo allocates the STOR_REQUEST_INFO structure. Prior to calling StorPortGetRequestInfo, Version must be set to STOR_REQUEST_INFO_VER_1 and Size must be set to sizeof(STOR_REQUEST_INFO). Otherwise, StorPortGetRequestInfo will return with a status of STOR_STATUS_INVALID_PARAMETER.

Requirements

Requirement Value
Minimum supported client Available in Windows 8 and later versions of Windows.
Header storport.h (include Storport.h)

See also

StorPortGetRequestInfo