NTMS_DRIVEINFORMATIONA structure (ntmsapi.h)

[Le Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La structure NTMS_DRIVEINFORMATION définit des propriétés spécifiques à un objet de lecteur.

Syntaxe

typedef struct _NTMS_DRIVEINFORMATIONA {
  DWORD      Number;
  DWORD      State;
  NTMS_GUID  DriveType;
  CHAR       szDeviceName[NTMS_DEVICENAME_LENGTH];
  CHAR       szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
  CHAR       szRevision[NTMS_REVISION_LENGTH];
  WORD       ScsiPort;
  WORD       ScsiBus;
  WORD       ScsiTarget;
  WORD       ScsiLun;
  DWORD      dwMountCount;
  SYSTEMTIME LastCleanedTs;
  NTMS_GUID  SavedPartitionId;
  NTMS_GUID  Library;
  GUID       Reserved;
  DWORD      dwDeferDismountDelay;
} NTMS_DRIVEINFORMATIONA;

Membres

Number

Numéro du lecteur dans la bibliothèque. Cette valeur est définie sur zéro ou une valeur relative en fonction du système de numérotation des lecteurs de l’appareil. Certains lecteurs de nombre de changeurs commençant par zéro, et d’autres commencent par un.

State

État du lecteur. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
NTMS_DRIVESTATE_BEING_CLEANED	Le lecteur est en cours de nettoyage et n’est pas disponible.
NTMS_DRIVESTATE_DISMOUNTABLE	Si une bibliothèque est définie pour les démontages différés, le support peut être laissé dans le lecteur de la bibliothèque sur un démontage. RSM peut satisfaire les demandes de montage pour les lecteurs chargés et démontés.
NTMS_DRIVESTATE_DISMOUNTED	Pas de moyen dans le lecteur.
NTMS_DRIVESTATE_LOADED	Le support est monté dans le lecteur et chargé pour l’accès en lecture et en écriture.
NTMS_DRIVESTATE_MOUNTED	Le support est monté dans le lecteur, mais n’est pas prêt pour l’accès en lecture et en écriture. Il s’agit d’un état temporaire utilisé pendant qu’un lecteur attend la synchronisation de broche ou le chargement d’un support de bande dans le mécanisme de tête.
NTMS_DRIVESTATE_UNLOADED	Le support a été démonté par le lecteur et est prêt à être ouvert. Cet état indique que la broche s’est arrêtée ou qu’un support de bande a été retourné à la cartouche de bande.

DriveType

Identificateur unique de l’objet de type de lecteur contenant les attributs du lecteur.

szDeviceName[NTMS_DEVICENAME_LENGTH]

Nom de l’appareil utilisé pour accéder au lecteur. Pour un lecteur de bande, contient le nom de l’appareil \.\tape0 ou \.\tape1. D’autres appareils fournissent le nom d’un lecteur de disque SCSI ou la racine d’un système de fichiers sur lequel l’appareil est actuellement monté (brut, NTFS, FAT, etc.).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

Numéro de série du lecteur représenté sous la forme d’une chaîne. Les appareils qui ne prennent pas en charge les numéros de série signalent la valeur NULL pour ce membre.

szRevision[NTMS_REVISION_LENGTH]

Révision du lecteur représenté sous la forme d’une chaîne.

ScsiPort

Adaptateur hôte SCSI auquel le lecteur est connecté.

ScsiBus

Bus SCSI auquel le lecteur est connecté.

ScsiTarget

ID cible SCSI pour le lecteur.

ScsiLun

ID d’unité logique SCSI pour le lecteur.

dwMountCount

Nombre de fois que le lecteur a eu un montage moyen sur celui-ci. Si le lecteur prend en charge la création d’un numéro de série unique, cette valeur correspond au nombre de fois où le lecteur a été monté depuis son installation. Si le lecteur ne prend pas en charge la création de rapports de numéros de série, ce membre reflète le nombre de montages sur tous les lecteurs à cet emplacement.

LastCleanedTs

La dernière fois que le lecteur a été nettoyé.

SavedPartitionId

Identificateur de partition du support qui se trouve dans le lecteur. Si cette valeur est NULL et que le lecteur est saturé, le média a été chargé par un utilisateur et doit être classifié.

Library

Identificateur unique de la bibliothèque qui contient le lecteur.

Reserved

Réservé.

dwDeferDismountDelay

Nombre minimal de secondes pendant lesquelles un support reste dans un lecteur d’une bibliothèque après l’exécution d’un démontage différé. La valeur par défaut est 5 minutes. Ce membre ne s’applique pas aux bibliothèques autonomes. Ce membre est accessible en écriture.

Remarques

La structure NTMS_DRIVEINFORMATION est incluse dans la structure NTMS_OBJECTINFORMATION .

Notes

L’en-tête ntmsapi.h définit NTMS_DRIVEINFORMATION en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	ntmsapi.h

Voir aussi

NTMS_OBJECTINFORMATION