Compartilhar via


estrutura STORAGE_PROTOCOL_DATA_DESCRIPTOR (winioctl.h)

Essa estrutura é usada em conjunto com IOCTL_STORAGE_QUERY_PROPERTY para retornar dados específicos do protocolo de um dispositivo de armazenamento ou adaptador. .

Sintaxe

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

Membros

Version

A versão dessa estrutura.

Size

O tamanho total do descritor, incluindo o espaço para todos os dados de protocolo.

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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY

STORAGE_PROTOCOL_SPECIFIC_DATA