VDS_DRIVE_PROP2-Struktur (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]

Definiert die Eigenschaften eines Laufwerkobjekts. Diese Struktur ist identisch mit der VDS_DRIVE_PROP-Struktur , mit der Ausnahme, dass sie die Gehäusenummer, den Bustyp und die Spindeldrehzahl als Member enthält.

Syntax

typedef struct _VDS_DRIVE_PROP2 {
  VDS_OBJECT_ID        id;
  ULONGLONG            ullSize;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszIdentification;
  ULONG                ulFlags;
  VDS_DRIVE_STATUS     status;
  VDS_HEALTH           health;
  SHORT                sInternalBusNumber;
  SHORT                sSlotNumber;
  ULONG                ulEnclosureNumber;
  VDS_STORAGE_BUS_TYPE busType;
  ULONG                ulSpindleSpeed;
} VDS_DRIVE_PROP2, *PVDS_DRIVE_PROP2;

Member

id

Die GUID des Laufwerkobjekts.

ullSize

Die Größe des Laufwerks in Byte.

pwszFriendlyName

Eine MIT NULL beendete Breitzeichenzeichenfolge, die den Namen des Laufwerks enthält.

pwszIdentification

Eine MIT NULL beendete Breitzeichenzeichenfolge, die den Laufwerkbezeichner enthält.

ulFlags

Eine Bitmaske von
VDS_DRIVE_FLAG Enumerationswerte.

status

Ein
VDS_DRIVE_STATUS Enumerationswert, der die status des Laufwerks angibt.

health

Ein VDS_HEALTH-Enumerationswert, der die Integritäts-status des Laufwerks angibt. Im Folgenden sind die gültigen Werte für diesen Member aufgeführt.

Windows Server 2008, Windows Vista und Windows Server 2003: VDS_H_REPLACED und VDS_H_PENDING_FAILURE werden nicht unterstützt.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_REPLACED (9)

VDS_H_PENDING_FAILURE (10)

sInternalBusNumber

Die Nummer des Busses, mit dem das Laufwerk verbunden ist. Diese Zahl ist ein vom Implementierer zugewiesener Wert, der den Bus innerhalb des Subsystems eindeutig identifiziert. Sie ist nicht durch die Anzahl der Busse eingeschränkt, die das Subsystem enthält, und sie steht nicht im Zusammenhang mit dem Wert des sNumberOfInternalBuses-Elements der VDS_SUB_SYSTEM_PROP-Struktur .

sSlotNumber

Die Nummer des Steckplatzes, den das Laufwerk belegt. Diese Zahl ist ein vom Implementierer zugewiesener Wert, der den Slot innerhalb des Busses eindeutig identifiziert. Sie ist nicht durch die Anzahl der Slots eingeschränkt, die der Bus enthält, und sie steht nicht im Zusammenhang mit dem Wert des sMaxNumberOfSlotsEachBus-Elements der VDS_SUB_SYSTEM_PROP-Struktur .

ulEnclosureNumber

Die Nummer des Gehäuses, das das Laufwerk enthält. Der Wert ULONG_MAX gibt an, dass diese Zahl nicht für das Laufwerk definiert ist. Da einige Gehäusenummerierungsschemas nullbasiert sind, ist null ein gültiger Wert für diesen Member. Dieser Member entspricht dem ulEnclosureNumber-Parameter der IVdsSubSystem2::GetDrive2-Methode .

busType

Ein VDS_STORAGE_BUS_TYPE Wert, der den Bustyp des Laufwerks angibt. Ein Wert von 0 bedeutet, dass der Bustyp unbekannt ist.

ulSpindleSpeed

Die Spindeldrehzahl des Laufwerks in RPM. Der Standardwert für dieses Element ist Null. Ein Wert von 0 bedeutet, dass die Spindeldrehzahl unbekannt ist. Der Wert 1 bedeutet, dass das Laufwerk über keine rotierenden Medien verfügt. (Es kann sich z. B. um ein Solid-State-Laufwerk sein.)

Hinweise

Diese Struktur wird von der IVdsDrive2::GetProperties2-Methode verwendet, um die Eigenschaften für ein Laufwerkobjekt zurückzugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	vds.h