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)

Weitere Informationen

STORAGE_MEDIA_TYPE

TapeMiniGetMediaTypes