BPIO_RESULTS structure (ntddstor.h)

The BPIO_RESULTS structure defines BypassIO operation-specific outputs for BPIO_OP_ENABLE and BPIO_OP_QUERY operations when a driver is failing the operation.

Syntax

typedef struct _BPIO_RESULTS {
  LONG   OpStatus;
  USHORT FailingDriverNameLen;
  WCHAR  FailingDriverName[32];
  USHORT FailureReasonLen;
  WCHAR  FailureReason[128];
} BPIO_RESULTS, *PBPIO_RESULTS;

Members

OpStatus

Receives a NTSTATUS code available to the caller that identifies why the failing driver cannot support BypassIO. This field should only be set by the first driver to fail the enable/query request.

FailingDriverNameLen

Receives the length of the string stored in FailingDriverName, in characters.

FailingDriverName[32]

Receives a string that specifies the name of the driver that failed the request. For diagnostic reasons, a driver must store its name when it fails a BPIO_OP_ENABLE or BPIO_OP_QUERY operation. The name must match the actual name of the driver that is used by the system; for example, ntfs.sys. This string is not guaranteed to be NULL-terminated.

FailureReasonLen

Receives the length of the string stored in FailingReason, in characters.

FailureReason[128]

Receives a unique, descriptive string describing why the driver vetoed the enable/query request. This string is used for diagnostic reasons, and should be in English so that it does not need to be localized. This string is not guaranteed to be NULL-terminated.

Remarks

See BypassIO for storage drivers for more information.

Requirements

Requirement Value
Minimum supported client Windows 11
Header ntddstor.h

See also

BPIO_OPERATIONS

IOCTL_STORAGE_MANAGE_BYPASS_IO