DEVICE_MEDIA_INFO-Struktur (ntddstor.h)
Ein Speicherklassentreiber gibt ein Array von DEVICE_MEDIA_INFO Strukturen zurück, die in eine GET_MEDIA_TYPES-Struktur eingebettet sind, als Reaktion auf eine IOCTL_STORAGE_GET_MEDIA_TYPES_EX Anforderung zur Gerätesteuerung.
Syntax
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;
Member
DeviceSpecific
DeviceSpecific.DiskInfo
Beschreibt einen nicht versetzbaren (festen) Datenträger.
DeviceSpecific.DiskInfo.Cylinders
Gibt die Anzahl der Zylinder auf diesem Datenträger an.
DeviceSpecific.DiskInfo.MediaType
Gibt eine MEDIA_TYPE von FixedMedia an.
DeviceSpecific.DiskInfo.TracksPerCylinder
Gibt die Anzahl der Spuren pro Zylinder an.
DeviceSpecific.DiskInfo.SectorsPerTrack
Gibt die Anzahl der Sektoren pro Spur an.
DeviceSpecific.DiskInfo.BytesPerSector
Gibt die Anzahl der Bytes pro Sektor an.
DeviceSpecific.DiskInfo.NumberMediaSides
Gibt die Anzahl der Seiten des Datenträgers an, die Daten enthalten können: entweder 1 für einseitige Medien oder 2 für zweiseitige Medien.
DeviceSpecific.DiskInfo.MediaCharacteristics
Gibt Die Merkmale des Datenträgers an, die durch eines oder mehrere der folgenden Flags angegeben sind.
- 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
Beschreibt einen Wechseldatenträger (ohne Fixierung).
DeviceSpecific.RemovableDiskInfo.Cylinders
Gibt die Anzahl der Zylinder auf diesem Datenträger an.
DeviceSpecific.RemovableDiskInfo.MediaType
Gibt einen MEDIA_TYPE - oder STORAGE_MEDIA_TYPE-Wert an, der den Typ des Wechseldatenträgers angibt.
DeviceSpecific.RemovableDiskInfo.TracksPerCylinder
Gibt die Anzahl der Spuren pro Zylinder an.
DeviceSpecific.RemovableDiskInfo.SectorsPerTrack
Gibt die Anzahl der Sektoren pro Spur an.
DeviceSpecific.RemovableDiskInfo.BytesPerSector
Gibt die Anzahl der Bytes pro Sektor an.
DeviceSpecific.RemovableDiskInfo.NumberMediaSides
Gibt die Anzahl der Seiten des Datenträgers an, die Daten enthalten können: 1 für einseitige Medien oder 2 für zweiseitige Medien.
DeviceSpecific.RemovableDiskInfo.MediaCharacteristics
Gibt Die Merkmale des Datenträgers an, die durch MEDIA_ XXX-Flags angezeigt werden, die zusammen verwendet werden. Eine Liste dieser Flags finden Sie im DeviceSpecific.DiskInfo.MediaCharacteristics-Member der DeviceSpecific.DiskInfo-Struktur .
DeviceSpecific.TapeInfo
Beschreibt ein Band.
DeviceSpecific.TapeInfo.MediaType
Gibt einen STORAGE_MEDIA_TYPE Wert an, der den In dieser Struktur beschriebenen Bandtyp angibt.
DeviceSpecific.TapeInfo.MediaCharacteristics
Gibt die Merkmale des Bandes an, die durch MEDIA_ XXX-Flags angezeigt werden, die zusammen verwendet werden. Eine Liste dieser Flags finden Sie im DeviceSpecific.DiskInfo.MediaCharacteristics-Member der DeviceSpecific.DiskInfo-Struktur .
DeviceSpecific.TapeInfo.CurrentBlockSize
Gibt die aktuelle Blockgröße in Bytes an.
DeviceSpecific.TapeInfo.BusType
Gibt einen Wert vom Typ STORAGE_BUS_TYPE an, der den Bustyp angibt.
DeviceSpecific.TapeInfo.BusSpecificData
DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation
Gibt busspezifische Informationen aus Seitendaten im Modus an, die das vom Bandlaufwerk unterstützte Medium beschreiben. Werte für andere Bustypen werden in einem späteren Release angegeben.
DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation.MediumType
Gibt den SCSI-spezifischen Mitteltyp an.
DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation.DensityCode
Gibt die aktuelle SCSI-spezifische Betriebsdichte für Lese-/Schreibvorgänge an.
Hinweise
Diese Struktur wird von einem Speichertreiber verwendet, um anzugeben, welche Medientypen von einem Gerät unterstützt werden und welcher Typ derzeit eingebunden wird, falls vorhanden. Ein Treiber muss diese Informationen bereitstellen, wenn er Laufwerke in einer Medienbibliothek oder einem Changer steuert oder ob der Wechselspeicher-Manager (RSM) auf sein Gerät zugreift.
Der Treiber füllt ein Array von DEVICE_MEDIA_INFO Strukturen aus, eines für jeden vom Gerät unterstützten Mitteltyp, der in eine GET_MEDIA_TYPES-Struktur eingebettet ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddstor.h (include Ntddstor.h, Minitape.h) |