estrutura DEVICE_MEDIA_INFO (ntddstor.h)

Um driver de classe de armazenamento retorna uma matriz de estruturas DEVICE_MEDIA_INFO , inseridas em uma estrutura GET_MEDIA_TYPES , em resposta a uma solicitação de controle de dispositivo IOCTL_STORAGE_GET_MEDIA_TYPES_EX .

Sintaxe

typedef struct _DEVICE_MEDIA_INFO {
  union {
    struct {
      LARGE_INTEGER      Cylinders;
      STORAGE_MEDIA_TYPE MediaType;
      ULONG              TracksPerCylinder;
      ULONG              SectorsPerTrack;
      ULONG              BytesPerSector;
      ULONG              NumberMediaSides;
      ULONG              MediaCharacteristics;
    } DiskInfo;
    struct {
      LARGE_INTEGER      Cylinders;
      STORAGE_MEDIA_TYPE MediaType;
      ULONG              TracksPerCylinder;
      ULONG              SectorsPerTrack;
      ULONG              BytesPerSector;
      ULONG              NumberMediaSides;
      ULONG              MediaCharacteristics;
    } RemovableDiskInfo;
    struct {
      STORAGE_MEDIA_TYPE MediaType;
      ULONG              MediaCharacteristics;
      ULONG              CurrentBlockSize;
      STORAGE_BUS_TYPE   BusType;
      union {
        struct {
          UCHAR MediumType;
          UCHAR DensityCode;
        } ScsiInformation;
      } BusSpecificData;
    } TapeInfo;
  } DeviceSpecific;
} DEVICE_MEDIA_INFO, *PDEVICE_MEDIA_INFO;

Membros

DeviceSpecific

DeviceSpecific.DiskInfo

Descreve um disco não reutilizável (fixo).

DeviceSpecific.DiskInfo.Cylinders

Especifica o número de cilindros neste disco.

DeviceSpecific.DiskInfo.MediaType

Especifica um MEDIA_TYPE de FixedMedia.

DeviceSpecific.DiskInfo.TracksPerCylinder

Especifica o número de faixas por cilindro.

DeviceSpecific.DiskInfo.SectorsPerTrack

Especifica o número de setores por trilha.

DeviceSpecific.DiskInfo.BytesPerSector

Especifica o número de bytes por setor.

DeviceSpecific.DiskInfo.NumberMediaSides

Especifica o número de lados do disco que podem conter dados: 1 para mídia unilateral ou 2 para mídia de dois lados.

DeviceSpecific.DiskInfo.MediaCharacteristics

Especifica as características do disco indicadas por um ou mais dos sinalizadores a seguir.

  • MEDIA_ERASEABLE 0x00000001
  • MEDIA_WRITE_ONCE 0x00000002
  • MEDIA_READ_ONLY 0x00000004
  • MEDIA_READ_WRITE 0x00000008
  • MEDIA_WRITE_PROTECTED 0x00000100
  • MEDIA_CURRENTLY_MOUNTED 0x80000000

DeviceSpecific.RemovableDiskInfo

Descreve um disco removível (não fixado).

DeviceSpecific.RemovableDiskInfo.Cylinders

Especifica o número de cilindros neste disco.

DeviceSpecific.RemovableDiskInfo.MediaType

Especifica um valor MEDIA_TYPE ou STORAGE_MEDIA_TYPE que indica o tipo de disco removível.

DeviceSpecific.RemovableDiskInfo.TracksPerCylinder

Especifica o número de faixas por cilindro.

DeviceSpecific.RemovableDiskInfo.SectorsPerTrack

Especifica o número de setores por trilha.

DeviceSpecific.RemovableDiskInfo.BytesPerSector

Especifica o número de bytes por setor.

DeviceSpecific.RemovableDiskInfo.NumberMediaSides

Especifica o número de lados do disco que podem conter dados: 1 para mídia unilateral ou 2 para mídia de dois lados.

DeviceSpecific.RemovableDiskInfo.MediaCharacteristics

Especifica características do disco, indicadas por MEDIA_XXX sinalizadores ORed juntos. Para obter uma lista desses sinalizadores, consulte o membro DeviceSpecific.DiskInfo.MediaCharacteristics da estrutura DeviceSpecific.DiskInfo .

DeviceSpecific.TapeInfo

Descreve uma fita.

DeviceSpecific.TapeInfo.MediaType

Especifica um valor STORAGE_MEDIA_TYPE que indica o tipo de fita descrito nesta estrutura.

DeviceSpecific.TapeInfo.MediaCharacteristics

Especifica características da fita, indicadas por MEDIA_XXX sinalizadores ORed juntos. Para obter uma lista desses sinalizadores, consulte o membro DeviceSpecific.DiskInfo.MediaCharacteristics da estrutura DeviceSpecific.DiskInfo .

DeviceSpecific.TapeInfo.CurrentBlockSize

Especifica o tamanho do bloco atual, em bytes.

DeviceSpecific.TapeInfo.BusType

Especifica um valor do tipo STORAGE_BUS_TYPE que indica o tipo de barramento.

DeviceSpecific.TapeInfo.BusSpecificData

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation

Especifica informações específicas do barramento de dados de página de modo que descrevem o meio compatível com a unidade de fita. Os valores para outros tipos de barramento serão fornecidos em uma versão posterior.

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation.MediumType

Especifica o tipo médio específico do SCSI.

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation.DensityCode

Especifica a densidade operacional atual específica do SCSI para operações de leitura/gravação.

Comentários

Essa estrutura é usada por um driver de armazenamento para indicar os tipos de mídia compatíveis com um dispositivo e qual tipo está montado no momento, se houver. Um driver deve fornecer essas informações se ele pode controlar unidades em uma biblioteca de mídia ou um alterador ou se seu dispositivo pode ser acessado pelo RSM (Gerenciador de Armazenamento Removível).

O driver preenche uma matriz de estruturas DEVICE_MEDIA_INFO , uma para cada tipo médio compatível com o dispositivo, inserida em uma estrutura GET_MEDIA_TYPES .

Requisitos

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

Confira também

STORAGE_MEDIA_TYPE

TapeMiniGetMediaTypes