структура 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) |