estrutura STORAGE_DEVICE_DESCRIPTOR (winioctl.h)
Usado em conjunto com o código de controle IOCTL_STORAGE_QUERY_PROPERTY para recuperar os dados do descritor de alinhamento do dispositivo de armazenamento para um dispositivo.
Sintaxe
typedef struct _STORAGE_DEVICE_DESCRIPTOR {
DWORD Version;
DWORD Size;
BYTE DeviceType;
BYTE DeviceTypeModifier;
BOOLEAN RemovableMedia;
BOOLEAN CommandQueueing;
DWORD VendorIdOffset;
DWORD ProductIdOffset;
DWORD ProductRevisionOffset;
DWORD SerialNumberOffset;
STORAGE_BUS_TYPE BusType;
DWORD RawPropertiesLength;
BYTE RawDeviceProperties[1];
} STORAGE_DEVICE_DESCRIPTOR, *PSTORAGE_DEVICE_DESCRIPTOR;
Membros
Version
Contém o tamanho dessa estrutura, em bytes. O valor desse membro será alterado à medida que os membros forem adicionados à estrutura.
Size
Especifica o tamanho total do descritor, em bytes, que pode incluir ID do fornecedor, ID do produto, revisão de produto, cadeias de caracteres de número de série do dispositivo e dados específicos do barramento que são acrescentados à 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 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 marcado por SCSI ou equivalente). Quando FALSE, o dispositivo não dá suporte à fila marcada por SCSI nem ao equivalente.
VendorIdOffset
Especifica o deslocamento de bytes do início da estrutura para uma cadeia de caracteres ASCII terminada em nulo 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 nulo que contém a ID do produto do dispositivo. Se o dispositivo não tiver nenhuma ID do produto, esse membro será zero.
ProductRevisionOffset
Especifica o deslocamento de bytes do início da estrutura para uma cadeia de caracteres ASCII terminada em nulo que contém a cadeia de caracteres de revisão de 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 nulo 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 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 que serve como um espaço reservado para o primeiro byte dos dados de propriedade específicos do barramento.
Comentários
Um aplicativo pode determinar o tamanho do buffer necessário emitindo um código de controle IOCTL_STORAGE_QUERY_PROPERTY passando uma estrutura STORAGE_DESCRIPTOR_HEADER para o buffer de saída e, em seguida, usando o membro Size retornado da estrutura STORAGE_DESCRIPTOR_HEADER para alocar um buffer do tamanho adequado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | winioctl.h (inclua Windows.h) |