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

Статья
08/07/2023

Драйвер класса хранилища возвращает массив 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

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

DiskInfo.MediaCharacteristics.MEDIA_CURRENTLY_MOUNTED

DiskInfo.MediaCharacteristics.MEDIA_ERASEABLE

DiskInfo.MediaCharacteristics.MEDIA_READ_ONLY

DiskInfo.MediaCharacteristics.MEDIA_READ_WRITE

DiskInfo.MediaCharacteristics.MEDIA_WRITE_ONCE

DiskInfo.MediaCharacteristics.MEDIA_WRITE_PROTECTED

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

DeviceSpecific.RemovableDiskInfo.MediaCharacteristics

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

DeviceSpecific.TapeInfo

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

DeviceSpecific.TapeInfo.MediaType

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

DeviceSpecific.TapeInfo.MediaCharacteristics

Задает характеристики ленты, обозначаемые вместе флагами 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 .

Требования

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

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

STORAGE_MEDIA_TYPE

TapeMiniGetMediaTypes

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