VDS_DRIVE_PROP2-Struktur (vdshwprv.h)

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

Definiert die Eigenschaften eines Laufwerkobjekts. Diese Struktur ist mit der VDS_DRIVE_PROP-Struktur identisch, mit der Ausnahme, dass sie die Gehäusenummer, den Bustyp und die Spindelgeschwindigkeit 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 Bytes.

pwszFriendlyName

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

pwszIdentification

Eine MIT NULL beendete breitzeichenige Zeichenfolge, die den Laufwerksbezeichner 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 dieses Element 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 Nummer ist ein vom Implementierer zugewiesener Wert, der den Bus innerhalb des Subsystems eindeutig identifiziert. Es ist nicht durch die Anzahl der Busse eingeschränkt, die das Subsystem enthält, und es ist nicht mit dem Wert des sNumberOfInternalBuses-Members der VDS_SUB_SYSTEM_PROP-Struktur verknüpft.

sSlotNumber

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

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 dieses Element. 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 0. 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