estructura STORAGE_PROTOCOL_DATA_DESCRIPTOR (ntddstor.h)

Artículo
02/07/2025

Esta estructura se usa junto con IOCTL_STORAGE_SET_PROPERTY y IOCTL_STORAGE_QUERY_PROPERTY para establecer o consultar datos específicos del protocolo de consulta respectivamente desde un dispositivo de almacenamiento o adaptador.

Sintaxis

typedef struct _STORAGE_PROTOCOL_DATA_DESCRIPTOR {
  ULONG                          Version;
  ULONG                          Size;
  STORAGE_PROTOCOL_SPECIFIC_DATA ProtocolSpecificData;
} STORAGE_PROTOCOL_DATA_DESCRIPTOR, *PSTORAGE_PROTOCOL_DATA_DESCRIPTOR;

Miembros

Version

Versión de esta estructura. Establezca en sizeof(STORAGE_PROTOCOL_DATA_DESCRIPTOR).

Size

Tamaño total en bytes del descriptor, incluido el espacio para todos los datos del protocolo. Debe ser =>tamaño de(STORAGE_PROTOCOL_DATA_DESCRIPTOR).

ProtocolSpecificData

Datos específicos del protocolo, de tipo STORAGE_PROTOCOL_SPECIFIC_DATA.

Observaciones

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 de STORAGE_PROTOCOL_SPECIFIC_DATA.
Establezca el campo PropertyID de en StorageAdapterProtocolSpecificProperty o StorageDeviceProtocolSpecificProperty para una solicitud de controlador o dispositivo o espacio de nombres, respectivamente.
Establezca el campo QueryType de en PropertyStandardQuery.
Rellene la estructura STORAGE_PROTOCOL_SPECIFIC_DATA con los valores deseados. El inicio del 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 de STORAGE_PROTOCOL_SPECIFIC_DATA de la siguiente manera:

Establezca el campo ProtocolType de en ProtocolTypeNVMe.
Establezca el campo DataType en un valor de enumeración definido por STORAGE_PROTOCOL_NVME_DATA_TYPE:
- Use nvMeDataTypeIdentify para obtener datos del controlador de identificación o identificar 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 de 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.