NTMS_DRIVEINFORMATIONA Struktur (ntmsapi.h)

[Wechselspeicher-Manager ist nicht mehr als Windows 7 und Windows Server 2008 R2 verfügbar.]

Die NTMS_DRIVEINFORMATION-Struktur definiert Eigenschaften, die für ein Laufwerkobjekt spezifisch sind.

Syntax

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;

Member

Number

Anzahl des Laufwerks in der Bibliothek. Dies ist null oder ein relativer Wert basierend auf dem Laufwerknummerierungssystem des Geräts festgelegt. Einige Änderungsnummernlaufwerke beginnen mit Null, und einige Änderungsgeber beginnen mit einem.

State

Zustand des Laufwerks. Dies kann eine der folgenden Werte sein.

Wert	Bedeutung
NTMS_DRIVESTATE_BEING_CLEANED	Das Laufwerk wird bereinigt und ist nicht verfügbar.
NTMS_DRIVESTATE_DISMOUNTABLE	Wenn eine Bibliothek für lazy dismounts festgelegt ist, wird das Medium möglicherweise auf dem Laufwerk der Bibliothek auf einem Dismount links sein. RSM kann Mountanforderungen für geladene und nicht bereitgestellte Laufwerke erfüllen.
NTMS_DRIVESTATE_DISMOUNTED	Kein Medium im Laufwerk.
NTMS_DRIVESTATE_LOADED	Das Medium wird im Laufwerk bereitgestellt und wird für Lese- und Schreibzugriff geladen.
NTMS_DRIVESTATE_MOUNTED	Das Medium wird im Laufwerk bereitgestellt, ist jedoch nicht für Lese- und Schreibzugriff bereit. Dies ist ein temporärer Zustand, der verwendet wird, während ein Laufwerk auf die Spindelsynchronisierung oder das Laden von Bandmedien in den Kopfmechanismus wartet.
NTMS_DRIVESTATE_UNLOADED	Das Medium wurde vom Laufwerk entfernt und ist bereit, geöffnet zu werden. Dieser Zustand gibt an, dass die Spindel beendet wurde oder ein Bandmedien an die Bandpatrone zurückgegeben wurde.

DriveType

Eindeutiger Bezeichner des Laufwerktypobjekts, das die Attribute für das Laufwerk enthält.

szDeviceName[NTMS_DEVICENAME_LENGTH]

Name des Geräts, das zum Zugriff auf das Laufwerk verwendet wird. Für ein Bandlaufwerk enthält dies den Gerätenamen \.\Tape0 oder \.\Tape1. Andere Geräte stellen den Namen eines SCSI-Datenträgerlaufwerks oder den Stamm eines Dateisystems bereit, das derzeit das Gerät bereitgestellt hat (roh, NTFS, FAT usw.).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

Seriennummer für das Laufwerk, das als Zeichenfolge dargestellt wird. Geräte, die keine Seriennummern unterstützen, melden NULL für dieses Element.

szRevision[NTMS_REVISION_LENGTH]

Überarbeitung für das Laufwerk, das als Zeichenfolge dargestellt wird.

ScsiPort

SCSI-Hostadapter, mit dem das Laufwerk verbunden ist.

ScsiBus

SCSI-Bus, mit dem das Laufwerk verbunden ist.

ScsiTarget

SCSI-Ziel-ID für das Laufwerk.

ScsiLun

SCSI-Logische Einheits-ID für das Laufwerk.

dwMountCount

Anzahl der Zeiten, in denen das Laufwerk ein mittelgehängtes Laufwerk aufweist. Wenn das Laufwerk die Berichterstellung einer eindeutigen Seriennummer unterstützt, ist dieser Wert die Anzahl der Zeiten, in denen das Laufwerk seit der Installation bereitgestellt wurde. Wenn das Laufwerk die Berichterstellung von Seriennummern nicht unterstützt, spiegelt dieses Element die Anzahl der Mounts an allen Laufwerken an diesem Speicherort wider.

LastCleanedTs

Zuletzt wurde das Laufwerk bereinigt.

SavedPartitionId

Partitionsbezeichner des Mediums, das sich im Laufwerk befindet. Wenn dieser Wert NULL ist und das Laufwerk vollständig gefunden wird, wurde die Medien von einem Benutzer geladen und muss klassifiziert werden.

Library

Eindeutiger Bezeichner der Bibliothek, die das Laufwerk enthält.

Reserved

Reserviert.

dwDeferDismountDelay

Die mindeste Anzahl von Sekunden, die ein Medium in einem Laufwerk einer Bibliothek bleibt, nachdem eine verzögerte Demount ausgeführt wurde. Die Standardeinstellung ist 5 Minuten. Dieses Element gilt nicht für eigenständige Bibliotheken. Dieses Element ist schreibbar.

Hinweise

Die NTMS_DRIVEINFORMATION Struktur ist in der NTMS_OBJECTINFORMATION Struktur enthalten.

Hinweis

Der ntmsapi.h-Header definiert NTMS_DRIVEINFORMATION als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstanten automatisch auswählt. Das Mischen der Verwendung des Codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann dazu führen, dass keine Übereinstimmungen auftreten, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	ntmsapi.h

Weitere Informationen

NTMS_OBJECTINFORMATION