estrutura STORAGE_PROTOCOL_DATA_DESCRIPTOR (ntddstor.h)

Artigo
08/07/2023

Essa estrutura é usada em conjunto com IOCTL_STORAGE_SET_PROPERTY e IOCTL_STORAGE_QUERY_PROPERTY para definir ou consultar, respectivamente, dados específicos do protocolo de um dispositivo ou adaptador de armazenamento.

Sintaxe

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

Membros

Version

Versão dessa estrutura. Defina como sizeof(STORAGE_PROTOCOL_DATA_DESCRIPTOR).

Size

Tamanho total em bytes do descritor, incluindo o espaço para todos os dados de protocolo. Deve ser =>sizeof(STORAGE_PROTOCOL_DATA_DESCRIPTOR).

ProtocolSpecificData

Os dados específicos do protocolo, do tipo STORAGE_PROTOCOL_SPECIFIC_DATA.

Comentários

Ao usar IOCTL_STORAGE_QUERY_PROPERTY para recuperar informações específicas do protocolo no STORAGE_PROTOCOL_DATA_DESCRIPTOR, configure a estrutura STORAGE_PROPERTY_QUERY da seguinte maneira:

Aloque um buffer que possa conter uma estrutura STORAGE_PROPERTY_QUERY e uma STORAGE_PROTOCOL_SPECIFIC_DATA.
Defina o campo PropertyID como StorageAdapterProtocolSpecificProperty ou StorageDeviceProtocolSpecificProperty para um controlador ou solicitação de dispositivo/namespace, respectivamente.
Defina o campo QueryType como PropertyStandardQuery.
Preencha a estrutura STORAGE_PROTOCOL_SPECIFIC_DATA com os valores desejados. O início da STORAGE_PROTOCOL_SPECIFIC_DATA é o campo AdditionalParameters da STORAGE_PROPERTY_QUERY.

Para especificar um tipo de informações específicas do protocolo NVMe, configure a estrutura STORAGE_PROTOCOL_SPECIFIC_DATA da seguinte maneira:

Defina o campo ProtocolType como ProtocolTypeNVMe.
Defina o campo DataType como um valor de enumeração definido por STORAGE_PROTOCOL_NVME_DATA_TYPE:
- Use NVMeDataTypeIdentify para obter dados do Controlador de identificação ou dados do Namespace de identificação.
- Use NVMeDataTypeLogPage para obter páginas de log (incluindo dados INTELIGENTES/integridade).
- Use NVMeDataTypeFeature para obter recursos da unidade NVMe.

Para especificar um tipo de informações específicas do protocolo ATA, configure a estrutura STORAGE_PROTOCOL_SPECIFIC_DATA da seguinte maneira:

Defina o campo ProtocolType como ProtocolTypeAta.
Defina o campo DataType como um valor de enumeração definido por STORAGE_PROTOCOL_ATA_DATA_TYPE:
- Use AtaDataTypeIdentify para identificar a unidade do ATA.
- Use AtaDataTypeLogPage para obter páginas de log da unidade do ATA.