Поделиться через

структура DEVICE_MEDIA_INFO (ntddstor.h)

  • Статья

Драйвер класса хранения возвращает массив DEVICE_MEDIA_INFO структур, внедренных в структуру GET_MEDIA_TYPES , в ответ на запрос IOCTL_STORAGE_GET_MEDIA_TYPES_EX управления устройством.

Синтаксис

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;

Члены

DeviceSpecific

DeviceSpecific.DiskInfo

Описывает несъемный (фиксированный) диск.

DeviceSpecific.DiskInfo.Cylinders

Указывает количество цилиндров на этом диске.

DeviceSpecific.DiskInfo.MediaType

Задает MEDIA_TYPEFixedMedia.

DeviceSpecific.DiskInfo.TracksPerCylinder

Указывает количество дорожек на цилиндр.

DeviceSpecific.DiskInfo.SectorsPerTrack

Задает количество секторов в дорожке.

DeviceSpecific.DiskInfo.BytesPerSector

Указывает количество байтов на сектор.

DeviceSpecific.DiskInfo.NumberMediaSides

Указывает количество сторон диска, которые могут содержать данные: 1 для односторонного носителя или 2 для двустороннего носителя.

DeviceSpecific.DiskInfo.MediaCharacteristics

Указывает характеристики диска, обозначаемые одним или несколькими из следующих флагов.

  • 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

Описывает съемный (безфиксированного) диск.

DeviceSpecific.RemovableDiskInfo.Cylinders

Указывает количество цилиндров на этом диске.

DeviceSpecific.RemovableDiskInfo.MediaType

Задает значение MEDIA_TYPE или STORAGE_MEDIA_TYPE , указывающее тип съемного диска.

DeviceSpecific.RemovableDiskInfo.TracksPerCylinder

Указывает количество дорожек на цилиндр.

DeviceSpecific.RemovableDiskInfo.SectorsPerTrack

Задает количество секторов в дорожке.

DeviceSpecific.RemovableDiskInfo.BytesPerSector

Указывает количество байтов на сектор.

DeviceSpecific.RemovableDiskInfo.NumberMediaSides

Указывает количество сторон диска, которые могут содержать данные: 1 для односторонного носителя или 2 для двустороннего носителя.

DeviceSpecific.RemovableDiskInfo.MediaCharacteristics

Указывает характеристики диска, обозначаемые флагами MEDIA_XXX . Список этих флагов см. в разделе Элемент DeviceSpecific.DiskInfo.MediaCharacteristics структуры DeviceSpecific.DiskInfo .

DeviceSpecific.TapeInfo

Описывает ленту.

DeviceSpecific.TapeInfo.MediaType

Задает значение STORAGE_MEDIA_TYPE , указывающее тип ленты, описанный в этой структуре.

DeviceSpecific.TapeInfo.MediaCharacteristics

Задает характеристики ленты, обозначаемые флагами ORed MEDIA_XXX . Список этих флагов см. в разделе Элемент DeviceSpecific.DiskInfo.MediaCharacteristics структуры DeviceSpecific.DiskInfo .

DeviceSpecific.TapeInfo.CurrentBlockSize

Указывает текущий размер блока в байтах.

DeviceSpecific.TapeInfo.BusType

Задает значение типа STORAGE_BUS_TYPE , указывающее тип шины.

DeviceSpecific.TapeInfo.BusSpecificData

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation

Указывает сведения о шине из данных страницы режима, описывающие среду, поддерживаемую ленточным накопителем. Значения для других типов шин будут предоставлены в более позднем выпуске.

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation.MediumType

Указывает тип среды SCSI.

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation.DensityCode

Указывает текущую плотность операций чтения и записи, зависят от SCSI.

Комментарии

Эта структура используется драйвером хранилища для указания типов носителей, поддерживаемых устройством, и того, какой тип подключен в данный момент, если таковой имеется. Драйвер должен предоставить эти сведения, если он может управлять дисками в библиотеке мультимедиа или в средстве смены или если его устройство может быть предоставлено диспетчером съемных носителей (RSM).

Драйвер заполняет массив DEVICE_MEDIA_INFO структур, по одной для каждого среднего типа, поддерживаемого устройством, и внедряется в структуру GET_MEDIA_TYPES .

Требования

Требование Значение
Заголовок ntddstor.h (включая Ntddstor.h, Minitape.h)

См. также раздел

STORAGE_MEDIA_TYPE

TapeMiniGetMediaTypes