structure NTMS_DRIVEINFORMATIONW (ntmsapi.h)

[Le Gestionnaire de stockage amovible n’est plus disponible à partir de 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. Cette valeur est définie sur zéro ou une relative sur la valeur en fonction du système de numérotation des lecteurs de l’appareil. Certains changeurs numérotent des lecteurs 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 en cours de nettoyage et n’est pas disponible.
NTMS_DRIVESTATE_DISMOUNTABLE	Si une bibliothèque est définie pour les démontages paresseux, le support peut être laissé dans le lecteur de la bibliothèque lors d’un démontage. RSM peut répondre aux demandes de montage pour les lecteurs chargés et démontés.
NTMS_DRIVESTATE_DISMOUNTED	Aucun support 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 il 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 fuseau ou le chargement du 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, 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 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 forme de 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 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ù un moyen a été monté sur le lecteur. 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 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 qu’un support reste dans un lecteur d’une bibliothèque après 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 comme un 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.

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