structure DEVICE_MEDIA_INFO (ntddstor.h)

  • Article

Un pilote de classe de stockage retourne un tableau de structures DEVICE_MEDIA_INFO , incorporées dans une structure de GET_MEDIA_TYPES , en réponse à une demande de contrôle d’appareil IOCTL_STORAGE_GET_MEDIA_TYPES_EX .

Syntaxe

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;

Membres

DeviceSpecific

DeviceSpecific.DiskInfo

Décrit un disque non modifiable (fixe).

DeviceSpecific.DiskInfo.Cylinders

Spécifie le nombre de cylindres sur ce disque.

DeviceSpecific.DiskInfo.MediaType

Spécifie une MEDIA_TYPE de FixedMedia.

DeviceSpecific.DiskInfo.TracksPerCylinder

Spécifie le nombre de pistes par cylindre.

DeviceSpecific.DiskInfo.SectorsPerTrack

Spécifie le nombre de secteurs par piste.

DeviceSpecific.DiskInfo.BytesPerSector

Spécifie le nombre d’octets par secteur.

DeviceSpecific.DiskInfo.NumberMediaSides

Spécifie le nombre de côtés du disque pouvant contenir des données : 1 pour le support unilatéd ou 2 pour le support double face.

DeviceSpecific.DiskInfo.MediaCharacteristics

Spécifie les caractéristiques du disque indiquées par un ou plusieurs des indicateurs suivants.

  • 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

Décrit un disque amovible (non corrigé).

DeviceSpecific.RemovableDiskInfo.Cylinders

Spécifie le nombre de cylindres sur ce disque.

DeviceSpecific.RemovableDiskInfo.MediaType

Spécifie une valeur MEDIA_TYPE ou STORAGE_MEDIA_TYPE qui indique le type de disque amovible.

DeviceSpecific.RemovableDiskInfo.TracksPerCylinder

Spécifie le nombre de pistes par cylindre.

DeviceSpecific.RemovableDiskInfo.SectorsPerTrack

Spécifie le nombre de secteurs par piste.

DeviceSpecific.RemovableDiskInfo.BytesPerSector

Spécifie le nombre d’octets par secteur.

DeviceSpecific.RemovableDiskInfo.NumberMediaSides

Spécifie le nombre de côtés du disque pouvant contenir des données : 1 pour le support unilatéd ou 2 pour le support double.

DeviceSpecific.RemovableDiskInfo.MediaCharacteristics

Spécifie les caractéristiques du disque, indiquées par MEDIA_XXX indicateurs ORed. Pour obtenir la liste de ces indicateurs, consultez le membre DeviceSpecific.DiskInfo.MediaCharacteristics de la structure DeviceSpecific.DiskInfo .

DeviceSpecific.TapeInfo

Décrit une bande.

DeviceSpecific.TapeInfo.MediaType

Spécifie une valeur STORAGE_MEDIA_TYPE qui indique le type de bande décrit dans cette structure.

DeviceSpecific.TapeInfo.MediaCharacteristics

Spécifie les caractéristiques de la bande, indiquées par MEDIA_XXX indicateurs ORed ensemble. Pour obtenir la liste de ces indicateurs, consultez le membre DeviceSpecific.DiskInfo.MediaCharacteristics de la structure DeviceSpecific.DiskInfo .

DeviceSpecific.TapeInfo.CurrentBlockSize

Spécifie la taille de bloc actuelle, en octets.

DeviceSpecific.TapeInfo.BusType

Spécifie une valeur de type STORAGE_BUS_TYPE qui indique le type de bus.

DeviceSpecific.TapeInfo.BusSpecificData

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation

Spécifie des informations spécifiques au bus à partir des données de page de mode qui décrivent le support pris en charge par le lecteur de bande. Les valeurs des autres types de bus seront fournies dans une version ultérieure.

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation.MediumType

Spécifie le type de support spécifique au SCSI.

DeviceSpecific.TapeInfo.BusSpecificData.ScsiInformation.DensityCode

Spécifie la densité de fonctionnement actuelle spécifique à SCSI pour les opérations de lecture/écriture.

Remarques

Cette structure est utilisée par un pilote de stockage pour indiquer les types de supports pris en charge par un appareil et le type actuellement monté, le cas échéant. Un pilote doit fournir ces informations s’il peut contrôler des lecteurs dans une bibliothèque multimédia ou un changeur ou si son appareil peut être accessible par le Gestionnaire de stockage amovible (RSM).

Le pilote remplit un tableau de structures DEVICE_MEDIA_INFO , une pour chaque type moyen pris en charge par l’appareil, incorporée dans une structure GET_MEDIA_TYPES .

Configuration requise

Condition requise Valeur
En-tête ntddstor.h (inclure Ntddstor.h, Minitape.h)

Voir aussi

STORAGE_MEDIA_TYPE

TapeMiniGetMediaTypes