structure NTMS_DRIVEINFORMATIONW (ntmsapi.h)

Article
11/20/2024

[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_DRIVEINFORMATIONW {
  DWORD      Number;
  DWORD      State;
  NTMS_GUID  DriveType;
  WCHAR      szDeviceName[NTMS_DEVICENAME_LENGTH];
  WCHAR      szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
  WCHAR      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_DRIVEINFORMATIONW;

Membres

Number

Numéro du lecteur dans la bibliothèque. Il s’agit de zéro ou d’une valeur relative basée sur le système de numérotation de lecteur de l’appareil. Certains changers de lecteur de nombre commençant par zéro, et certains changeurs 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 nettoyé 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	Aucun moyen dans le lecteur.
NTMS_DRIVESTATE_LOADED	Le support est monté dans le lecteur et est 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 broches ou le chargement du média sur bande dans le mécanisme principal.
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, il 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 qui dispose actuellement de l’appareil monté (brut, NTFS, FAT, etc.).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

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

szRevision[NTMS_REVISION_LENGTH]

Révision du lecteur représenté sous forme de 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 où le lecteur a eu un support monté sur celui-ci. Si le lecteur prend en charge la création de rapports d’un numéro de série unique, cette valeur est le 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

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 trouvé plein, 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 de 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.

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	ntmsapi.h

Voir aussi

NTMS_OBJECTINFORMATION

Partager via