IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ehstorbandmgmt.h
// CTL_CODE(0x002d, 0x527, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 0x002D149C
View the official Windows Driver Kit DDI referenceNo description available.
Metadata associated with a band is retrieved with an IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA request. The metadata for a band serves as a data area for a key manager application.
The input buffer at Irp->AssociatedIrp.SystemBuffer must contain a GET_BAND_METADATA_PARAMETERS structure.
Parameters.DeviceIoControl.InputBufferLength indicates the size, in bytes, of the buffer, which must be at least sizeof (GET_BAND_METADATA_PARAMETERS).
The output buffer at Irp->AssociatedIrp.SystemBuffer contains a byte array of band metadata specified by GET_BAND_METADATA_PARAMETERS.
The length of a GET_BAND_METADATA_PARAMETERS structure.
The Information field contains the number of bytes returned in the output buffer. One of the following values can be returned in the Status field.
| Status Value | Description |
|---|---|
| STATUS_SUCCESS | The metadata was returned in the system buffer. |
| STATUS_INVALID_DEVICE_REQUEST | The storage device does not support band management. |
| STATUS_INVALID_BUFFER_SIZE | The output buffer size is incorrect. |
| STATUS_INVALID_PARAMETER | Information in the input buffer is invalid. |
| STATUS_NOT_FOUND | The band was not found for the selection criteria provided. |
| STATUS_IO_DEVICE_ERROR | Communication failed. The storage device might be incompatible with security protocols. |
Authentication for this IOCTL is unnecessary and an authentication key is not included as input.