estrutura STORAGE_DEVICE_DESCRIPTOR (ntddstor.h)

Artigo
08/07/2023

A estrutura STORAGE_DEVICE_DESCRIPTOR é usada em conjunto com a solicitação IOCTL_STORAGE_QUERY_PROPERTY para recuperar os dados do descritor do dispositivo de armazenamento para um dispositivo.

Sintaxe

typedef struct _STORAGE_DEVICE_DESCRIPTOR {
  ULONG            Version;
  ULONG            Size;
  UCHAR            DeviceType;
  UCHAR            DeviceTypeModifier;
  BOOLEAN          RemovableMedia;
  BOOLEAN          CommandQueueing;
  ULONG            VendorIdOffset;
  ULONG            ProductIdOffset;
  ULONG            ProductRevisionOffset;
  ULONG            SerialNumberOffset;
  STORAGE_BUS_TYPE BusType;
  ULONG            RawPropertiesLength;
  UCHAR            RawDeviceProperties[1];
} STORAGE_DEVICE_DESCRIPTOR, *PSTORAGE_DEVICE_DESCRIPTOR;

Membros

Version

Indica o tamanho da estrutura STORAGE_DEVICE_DESCRIPTOR . O valor desse membro será alterado à medida que os membros forem adicionados à estrutura .

Size

Especifica o tamanho total do descritor em bytes, incluindo cadeias de caracteres de ID que são acrescentadas à estrutura.

DeviceType

Especifica o tipo de dispositivo conforme definido pela especificação SCSI (Small Computer Systems Interface).

DeviceTypeModifier

Especifica o modificador de tipo de dispositivo, se houver, conforme definido pela especificação SCSI. Se nenhum modificador de tipo de dispositivo existir, esse membro será zero.

RemovableMedia

Indica quando TRUE que a mídia do dispositivo (se houver) é removível. Se o dispositivo não tiver mídia, esse membro deverá ser ignorado. Quando FALSE , a mídia do dispositivo não é removível.

CommandQueueing

Indica quando TRUE o dispositivo dá suporte a vários comandos pendentes (enfileiramento scsi marcado ou equivalente). Quando FALSE, o dispositivo não dá suporte ao enfileiramento marcado por SCSI ou ao equivalente. O driver STORPORT é responsável por sincronizar os comandos.

VendorIdOffset

Especifica o deslocamento de bytes do início da estrutura para uma cadeia de caracteres ASCII terminada em NULL que contém a ID do fornecedor do dispositivo. Se o dispositivo não tiver nenhuma ID de fornecedor, esse membro será zero.

ProductIdOffset

Especifica o deslocamento de bytes do início da estrutura para uma cadeia de caracteres ASCII terminada em NULL que contém a ID do produto do dispositivo. Se o dispositivo não tiver nenhuma ID de produto, esse membro será zero.

ProductRevisionOffset

Especifica o deslocamento de bytes do início da estrutura para uma cadeia de caracteres ASCII terminada em NULL que contém a cadeia de caracteres de revisão do produto do dispositivo. Se o dispositivo não tiver nenhuma cadeia de caracteres de revisão do produto, esse membro será zero.

SerialNumberOffset

Especifica o deslocamento de bytes do início da estrutura para uma cadeia de caracteres ASCII terminada em NULL que contém o número de série do dispositivo. Se o dispositivo não tiver nenhum número de série, esse membro será zero.

BusType

Especifica um valor de enumerador do tipo STORAGE_BUS_TYPE que indica o tipo de barramento ao qual o dispositivo está conectado. Isso deve ser usado para interpretar as propriedades do dispositivo bruto no final dessa estrutura (se houver).

RawPropertiesLength

Indica o número de bytes de dados específicos do barramento que foram acrescentados a esse descritor.

RawDeviceProperties[1]

Contém uma matriz de comprimento um que serve como um espaço reservado para o primeiro byte dos dados de propriedade específicos do barramento.

Comentários

Aplicativos e drivers de classe de armazenamento emitem uma solicitação de controle de dispositivo com o código de controle de E/ S IOCTL_STORAGE_QUERY_PROPERTY para recuperar essa estrutura, que contém informações sobre um dispositivo de destino. A estrutura só pode ser recuperada de um FDO; tentar recuperar propriedades do dispositivo de um adaptador causa um erro.

Um aplicativo ou driver pode determinar o tamanho do buffer necessário convertendo a estrutura de STORAGE_DEVICE_DESCRIPTOR recuperada em um STORAGE_DESCRIPTOR_HEADER, que contém apenas Versão e Tamanho.