structure DEVICE_MEDIA_INFO (minitape.h)
Un pilote de classe de stockage retourne un tableau de structures DEVICE_MEDIA_INFO, incorporées dans une structure 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 nonremovable (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 qui peuvent contenir des données : soit 1 pour un média unilatéraux, soit 2 pour un support à deux côtés.
DeviceSpecific.DiskInfo.MediaCharacteristics
Spécifie les caractéristiques du disque indiqué par un ou plusieurs des indicateurs suivants.
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
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 qui peuvent contenir des données : 1 pour un média unidimensionné ou 2 pour un support à deux côtés.
DeviceSpecific.RemovableDiskInfo.MediaCharacteristics
Spécifie les caractéristiques du disque, indiquées par MEDIA_XXX indicateurs ORed ensemble. Pour obtenir la liste de ces indicateurs, consultez la DeviceSpecific.DiskInfo.MediaCharacteristics membre 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 la DeviceSpecific.DiskInfo.MediaCharacteristics membre 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 en 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 à 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 quel type est actuellement monté, le cas échéant. Un pilote doit fournir ces informations s’il peut contrôler les lecteurs d’une bibliothèque multimédia ou changer ou si son appareil peut être accessible par le Gestionnaire de stockage amovible (RSM).
Le pilote remplit un tableau de structures DEVICE_MEDIA_INFO, un pour chaque type moyen pris en charge par l’appareil, incorporé dans une structure GET_MEDIA_TYPES.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | minitape.h (include Ntddstor.h, Minitape.h) |