VDS_VOLUME_PROP2 Struktur (vds.h)

Artikel
03/03/2024

[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 Volumeobjekts. Diese Struktur ist identisch mit der VDS_VOLUME_PROP-Struktur , mit der Ausnahme, dass sie auch die Volume-GUIDs enthält.

Syntax

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

Member

id

Die GUID des Volumes.

type

Ein VDS_VOLUME_TYPE Enumerationswert, der den Volumetyp angibt. Volumetypen sind einfach, überspannt, gestreift (RAID-0), gespiegelt oder mit Parität (RAID-5) gestreift.

status

Ein VDS_VOLUME_STATUS-Enumerationswert, der die status des Volumes angibt.

health

Ein VDS_HEALTH Enumerationswert, der den Integritätszustand des Volumes angibt.

TransitionState

Ein VDS_TRANSITION_STATE Enumerationswert, der den Übergangsstatus des Volumes angibt.

ullSize

Die Größe des Volumes in Bytes.

ulFlags

Eine Bitmaske von VDS_VOLUME_FLAG Enumerationswerte, die das Volume beschreiben.

RecommendedFileSystemType

Ein VDS_FILE_SYSTEM_TYPE Enumerationswert, der das bevorzugte Dateisystem für das Volume angibt. Muss einer der folgenden Sein: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS oder VDS_FST_UNKNOWN.

cbUniqueId

Die Länge des Bytearrays, auf das der pUniqueId-Member zeigt.

pwszName

Der Name, der zum Öffnen eines Handles für das Volume mit der CreateFile-Funktion verwendet wurde. Beispiel: \?\GLOBALROOT\Device\HarddiskVolume1.

pUniqueId

Ein Bytearray, das den eindeutigen Bezeichner für das Volume enthält.

Hinweise

Die IVdsVolume2::GetProperties2-Methode gibt diese Struktur zurück, um die Eigenschaften eines Volumeobjekts zu melden.

Wenn ein Volume offline ist, wird das flag VDS_VF_PERMANENTLY_DISMOUNTED im ulFlags-Element der VDS_VOLUME_PROP2-Struktur festgelegt, und der VDS_VS_OFFLINE volume status-Wert wird auch im status-Element dieser Struktur festgelegt.

Für GPT- und dynamische Volumes ist der eindeutige Bezeichner, auf den das pUniqueId-Element verweist, global eindeutig.

Für Wechselmedienlaufwerke ist das Volume vorhanden und verfügt über einen eigenen eindeutigen Bezeichner, auch wenn keine Medien auf dem Gerät vorhanden sind. Wenn ein Volume auf Wechselmedien formatiert ist, verfügt dieses Volume über einen eigenen eindeutigen Bezeichner. Weitere Informationen finden Sie unter Unterstützen von Einbindungs-Manager-Anforderungen in einem Speicherklassentreiber.

Das Format des eindeutigen Bezeichners kann zwischen verschiedenen Gerätetypen und Volumes variieren. Bei Basisvolumes auf MBR-Datenträgern basiert der eindeutige Bezeichner auf der Datenträgersignatur und dem Partitionsoffset. Da die Datenträgersignatur und der Partitionsoffset DWORD-Werte sind, kann nicht garantiert werden, dass der eindeutige Bezeichner computerübergreifend global eindeutig ist.

Wenn sich die Datenträgersignatur ändert, ändert sich auch der eindeutige Bezeichner des Volumes. Änderungen der Datenträgersignatur treten in der Regel als Folge einer Kollision während des Klonens von Datenträgern auf.

Beachten Sie, dass ein eindeutiger Bezeichner nicht mit einem Volume-GUID-Pfad identisch ist. Um die Volume-GUID-Pfade für ein Volume zu finden, verwenden Sie die IVdsVolumeMF3::QueryVolumeGuidPathnames-Methode .

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