Compartir a través de

estructura STORAGE_PROTOCOL_SPECIFIC_DATA (winioctl.h)

  • Artículo

Describe los datos del dispositivo específicos del protocolo, proporcionados en el búfer de entrada y salida de una solicitud IOCTL_STORAGE_QUERY_PROPERTY.

Sintaxis

typedef struct _STORAGE_PROTOCOL_SPECIFIC_DATA {
  STORAGE_PROTOCOL_TYPE ProtocolType;
  DWORD                 DataType;
  DWORD                 ProtocolDataRequestValue;
  DWORD                 ProtocolDataRequestSubValue;
  DWORD                 ProtocolDataOffset;
  DWORD                 ProtocolDataLength;
  DWORD                 FixedProtocolReturnData;
  DWORD                 ProtocolDataRequestSubValue2;
  DWORD                 ProtocolDataRequestSubValue3;
  DWORD                 ProtocolDataRequestSubValue4;
} STORAGE_PROTOCOL_SPECIFIC_DATA, *PSTORAGE_PROTOCOL_SPECIFIC_DATA;

Miembros

ProtocolType

Tipo de protocolo. Los valores de este miembro se definen en la enumeración STORAGE_PROTOCOL_TYPE .

DataType

Tipo de datos de protocolo. Los tipos de datos se definen en las enumeraciones STORAGE_PROTOCOL_NVME_DATA_TYPE y STORAGE_PROTOCOL_ATA_DATA_TYPE .

ProtocolDataRequestValue

Valor de solicitud de datos de protocolo.

ProtocolDataRequestSubValue

Subvalor de la solicitud de datos de protocolo.

ProtocolDataOffset

Desplazamiento del búfer de datos que está desde el principio de esta estructura. El valor típico puede ser sizeof(STORAGE_PROTOCOL_SPECIFIC_DATA).

ProtocolDataLength

Longitud de los datos del protocolo.

FixedProtocolReturnData

Datos devueltos.

ProtocolDataRequestSubValue2

ProtocolDataRequestSubValue3

ProtocolDataRequestSubValue4

Comentarios

Al usar IOCTL_STORAGE_QUERY_PROPERTY para recuperar información específica del protocolo en el STORAGE_PROTOCOL_DATA_DESCRIPTOR, configure la estructura de STORAGE_PROPERTY_QUERY de la siguiente manera:

  • Asigne un búfer que pueda contener una STORAGE_PROPERTY_QUERY y una estructura STORAGE_PROTOCOL_SPECIFIC_DATA.
  • Establezca el campo PropertyID en StorageAdapterProtocolSpecificProperty o en StorageDeviceProtocolSpecificProperty para una solicitud de controlador o espacio de nombres, respectivamente.
  • Establezca el campo QueryType en PropertyStandardQuery.
  • Rellene la estructura STORAGE_PROTOCOL_SPECIFIC_DATA con los valores deseados. El inicio de STORAGE_PROTOCOL_SPECIFIC_DATA es el campo AdditionalParameters de STORAGE_PROPERTY_QUERY.
Para especificar un tipo de información específica del protocolo NVMe, configure la estructura STORAGE_PROTOCOL_SPECIFIC_DATA de la siguiente manera:
  • Establezca el campo ProtocolType en ProtocolTypeNVMe.
  • Establezca el campo DataType en un valor de enumeración definido por STORAGE_PROTOCOL_NVME_DATA_TYPE:
    • Use NVMeDataTypeIdentify para obtener los datos del controlador de identificación o para identificar los datos del espacio de nombres.
    • Use NVMeDataTypeLogPage para obtener páginas de registro (incluidos los datos SMART/health).
    • Use NVMeDataTypeFeature para obtener características de la unidad NVMe.
Para especificar un tipo de información específica del protocolo ATA, configure la estructura STORAGE_PROTOCOL_SPECIFIC_DATA de la siguiente manera:
  • Establezca el campo ProtocolType en ProtocolTypeAta.
  • Establezca el campo DataType en un valor de enumeración definido por STORAGE_PROTOCOL_ATA_DATA_TYPE:
    • Use AtaDataTypeIdentify para identificar la unidad ATA.
    • Use AtaDataTypeLogPage para obtener páginas de registro de la unidad ATA.

Requisitos

   
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Encabezado winioctl.h (incluye Windows.h)

Consulte también

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY