NTMS_DRIVEINFORMATIONA Struktur (ntmsapi.h)

Artikel
11/20/2024

[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr 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;

Angehörige

Number

Die Nummer des Laufwerks in der Bibliothek. Dies wird null oder ein relativer Wert basierend auf dem Laufwerknummerierungssystem des Geräts festgelegt. Einige Änderungsnummernlaufwerke beginnen mit 0, und einige Changer beginnen mit einem.

State

Zustand des Laufwerks. Dies kann einer 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, befindet sich das Medium möglicherweise auf dem Laufwerk der Bibliothek auf einer Dismount-Bereitstellung. RSM kann Bereitstellungsanforderungen für geladene und nicht bereitgestellte Laufwerke erfüllen.
NTMS_DRIVESTATE_DISMOUNTED	Kein Medium auf dem Laufwerk.
NTMS_DRIVESTATE_LOADED	Das Medium wird auf dem Laufwerk bereitgestellt und für Lese- und Schreibzugriff geladen.
NTMS_DRIVESTATE_MOUNTED	Das Medium wird auf dem Laufwerk bereitgestellt, ist aber 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 aufgehoben und kann geöffnet werden. Dieser Zustand gibt an, dass die Spindel angehalten wurde oder ein Bandmedium 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 für den Zugriff auf das Laufwerk verwendet wird. Für ein Bandlaufwerk enthält dies den Gerätenamen \.\tape0 oder \.\tape1. Andere Geräte geben den Namen eines SCSI-Datenträgerlaufwerks oder den Stamm eines Dateisystems an, das derzeit das Gerät bereitgestellt hat (unformatiert, NTFS, FAT usw.).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

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

szRevision[NTMS_REVISION_LENGTH]

Revision 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

Id der logischen SCSI-Einheit für das Laufwerk.

dwMountCount

Die Häufigkeit, mit der das Laufwerk einen Mittleren bereitgestellt hat. Wenn das Laufwerk die Berichterstellung einer eindeutigen Seriennummer unterstützt, ist dieser Wert die Häufigkeit, mit der das Laufwerk seit der Installation bereitgestellt wurde. Wenn das Laufwerk die Berichterstattung über Seriennummern nicht unterstützt, gibt dieses Element die Anzahl der Bereitstellungen an allen Laufwerken an diesem Speicherort an.

LastCleanedTs

Das letzte Mal, wenn das Laufwerk bereinigt wurde.

SavedPartitionId

Partitionsbezeichner des Mediums, das sich auf dem Laufwerk befindet. Wenn dieser Wert NULL ist und das Laufwerk voll ist, wurde das Medium 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 verbleibt, nachdem eine verzögerte Bereitstellung ausgeführt wurde. Der Standardwert ist 5 Minuten. Dieses Mitglied gilt nicht für eigenständige Bibliotheken. Dieses Element ist schreibbar.

Bemerkungen

Die NTMS_DRIVEINFORMATION Struktur ist in der NTMS_OBJECTINFORMATION Struktur enthalten.

Anmerkung

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	ntmsapi.h

Siehe auch

NTMS_OBJECTINFORMATION

Freigeben über