estrutura STORAGE_DEVICE_NUMBER (ntddstor.h)

  • Artigo

A estrutura STORAGE_DEVICE_NUMBER é usada em conjunto com a solicitação IOCTL_STORAGE_GET_DEVICE_NUMBER para recuperar o tipo de dispositivo FILE_DEVICE_XXX , o número do dispositivo e, para um dispositivo que pode ser particionado, o número de partição atribuído a um dispositivo pelo driver quando o dispositivo é iniciado.

Sintaxe

typedef struct _STORAGE_DEVICE_NUMBER {
  DEVICE_TYPE DeviceType;
  ULONG       DeviceNumber;
  ULONG       PartitionNumber;
} STORAGE_DEVICE_NUMBER, *PSTORAGE_DEVICE_NUMBER;

Membros

DeviceType

Especifica uma das constantes FILE_DEVICE_XXX definidas pelo sistema que indicam o tipo de dispositivo (como FILE_DEVICE_DISK, FILE_DEVICE_KEYBOARD e assim por diante) ou um valor definido pelo fornecedor para um novo tipo de dispositivo. Para obter mais informações, consulte Especificando tipos de dispositivo.

DeviceNumber

Indica o número deste dispositivo. Esse valor é definido como 0xFFFFFFFF (-1) para os discos que representam os caminhos físicos de um disco MPIO.

PartitionNumber

Indica que o número de partição do dispositivo será retornado neste membro, se o dispositivo puder ser particionado. Caso contrário, -1 será retornado.

Comentários

A solicitação IOCTL_STORAGE_GET_DEVICE_NUMBER geralmente é emitida por um driver de disco tolerante a falhas.

Os valores na estrutura STORAGE_DEVICE_NUMBER têm a garantia de permanecer inalterados até que o sistema seja reinicializado. Não há garantia de que eles sejam persistentes entre as botas.

Requisitos

Requisito Valor
Cabeçalho ntddstor.h (inclua Ntddstor.h)

Confira também

IOCTL_STORAGE_GET_DEVICE_NUMBER