NTMS_DRIVEINFORMATIONW-Struktur (ntmsapi.h)

Artikel
08/25/2023

[Wechseldatenträger-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_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;

Member

Number

Nummer des Laufwerks in der Bibliothek. Dies ist null oder ein relativer Wert basierend auf dem Laufwerknummerierungssystem des Geräts. Einige Veränderernummernlaufwerke beginnen mit null, 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, wird das Medium möglicherweise auf dem Laufwerk der Bibliothek bei einer Demountierung belassen. RSM kann Bereitstellungsanforderungen für geladene und nicht bereitgestellte Laufwerke erfüllen.
NTMS_DRIVESTATE_DISMOUNTED	Kein Medium im Laufwerk.
NTMS_DRIVESTATE_LOADED	Das Medium wird in das Laufwerk eingebunden und für lese- und schreibzugriff geladen.
NTMS_DRIVESTATE_MOUNTED	Das Medium wird in das Laufwerk eingebunden, ist aber nicht bereit für lese- und schreibzugriff. Dies ist ein temporärer Zustand, der verwendet wird, während ein Laufwerk auf die Spindelsynchronisierung wartet oder Bandmedien in den Hauptmechanismus lädt.
NTMS_DRIVESTATE_UNLOADED	Das Medium wurde vom Laufwerk entfernt und kann geöffnet werden. Dieser Zustand gibt an, dass die Spindel angehalten oder ein Bandmedium an die Bandkassette 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, auf dem das Gerät derzeit eingebunden ist (unformatiert, 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]

Revision für das Laufwerk, das als Zeichenfolge dargestellt wird.

ScsiPort

SCSI-Hostadapter, mit dem das Laufwerk verbunden ist.

ScsiBus

SCSI-Bus, an den das Laufwerk angeschlossen ist.

ScsiTarget

SCSI-Ziel-ID für das Laufwerk.

ScsiLun

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

dwMountCount

Die Häufigkeit, in die das Laufwerk ein Medium eingebunden hat. Wenn das Laufwerk die Berichterstellung einer eindeutigen Seriennummer unterstützt, ist dieser Wert die Anzahl der Einbindungen des Laufwerks seit der Installation. Wenn das Laufwerk die Meldung von Seriennummern nicht unterstützt, gibt dieses Element die Anzahl der Bereitstellungen an allen Laufwerken an diesem Speicherort an.

LastCleanedTs

Das letzte Mal wurde das Laufwerk bereinigt.

SavedPartitionId

Partitionsbezeichner des Mediums, das sich im Laufwerk befindet. Wenn dieser Wert NULL ist und das Laufwerk als voll eingestuft wird, wurden die Medien von einem Benutzer geladen und müssen klassifiziert werden.

Library

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

Reserved

Reserviert.

dwDeferDismountDelay

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

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äprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	ntmsapi.h

Weitere Informationen

NTMS_OBJECTINFORMATION

Freigeben über