GET_VIRTUAL_DISK_INFO-Struktur (virtdisk.h)

Enthält VHD-Informationen (Virtual Hard Disk).

Syntax

typedef struct _GET_VIRTUAL_DISK_INFO {
  GET_VIRTUAL_DISK_INFO_VERSION Version;
  union {
    struct {
      ULONGLONG VirtualSize;
      ULONGLONG PhysicalSize;
      ULONG     BlockSize;
      ULONG     SectorSize;
    } Size;
    GUID                 Identifier;
    struct {
      BOOL  ParentResolved;
      WCHAR ParentLocationBuffer[1];
    } ParentLocation;
    GUID                 ParentIdentifier;
    ULONG                ParentTimestamp;
    VIRTUAL_STORAGE_TYPE VirtualStorageType;
    ULONG                ProviderSubtype;
    BOOL                 Is4kAligned;
    BOOL                 IsLoaded;
    struct {
      ULONG LogicalSectorSize;
      ULONG PhysicalSectorSize;
      BOOL  IsRemote;
    } PhysicalDisk;
    ULONG                VhdPhysicalSectorSize;
    ULONGLONG            SmallestSafeVirtualSize;
    ULONG                FragmentationPercentage;
    GUID                 VirtualDiskId;
    struct {
      BOOL  Enabled;
      BOOL  NewerChanges;
      WCHAR MostRecentId[1];
    } ChangeTrackingState;
  };
} GET_VIRTUAL_DISK_INFO, *PGET_VIRTUAL_DISK_INFO;

Member

Version

Ein Wert der GET_VIRTUAL_DISK_INFO_VERSION-Enumeration , der die Version der GET_VIRTUAL_DISK_INFO-Struktur an oder von den Funktionen des virtuellen Datenträgers angibt. Dadurch wird bestimmt, welche Teile dieser Struktur verwendet werden.

Size

Eine Struktur mit den folgenden Membern. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_SIZE fest.

Size.VirtualSize

Virtuelle Größe des virtuellen Datenträgers in Bytes.

Size.PhysicalSize

Physische Größe des virtuellen Datenträgers auf dem physischen Datenträger in Bytes.

Size.BlockSize

Blockgröße des virtuellen Datenträgers in Bytes.

Size.SectorSize

Sektorgröße des virtuellen Datenträgers in Bytes.

Identifier

Eindeutiger Bezeichner des virtuellen Datenträgers. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_IDENTIFIER fest.

ParentLocation

Eine Struktur mit den folgenden Membern. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_PARENT_LOCATION fest.

ParentLocation.ParentResolved

Übergeordnete Auflösung. TRUE , wenn der übergeordnete Sicherungsspeicher erfolgreich aufgelöst wurde, FALSE , falls nicht.

ParentLocation.ParentLocationBuffer[1]

Wenn das ParentResolved-ElementTRUE ist, enthält den Pfad des übergeordneten Sicherungsspeichers.

Wenn das ParentResolved-ElementFALSE ist, enthält alle übergeordneten Pfade in der Suchliste.

ParentIdentifier

Eindeutiger Bezeichner des übergeordneten Datenträgersicherungsspeichers. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_PARENT_IDENTIFIER fest.

ParentTimestamp

Interner Zeitstempel des übergeordneten Datenträgersicherungsspeichers. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_PARENT_TIMESTAMP fest.

VirtualStorageType

VIRTUAL_STORAGE_TYPE Struktur, die Informationen zum Typ des virtuellen Datenträgers enthält. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_VIRTUAL_STORAGE_TYPE fest.

ProviderSubtype

Anbieterspezifischer Untertyp. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_PROVIDER_SUBTYPE fest.

Wert Bedeutung
2
Fest.
3
Dynamisch erweiterbar (Sparse).
4
Differenzierend.

Is4kAligned

Gibt an, ob der virtuelle Datenträger 4 KB ausgerichtet ist. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_IS_4K_ALIGNED fest.

Windows 7 und Windows Server 2008 R2: Dies wird vor Windows 8 und Windows Server 2012 nicht unterstützt.

IsLoaded

Gibt an, ob der virtuelle Datenträger derzeit eingebunden und verwendet wird. TRUE , wenn der virtuelle Datenträger derzeit eingebunden und verwendet wird; andernfalls FALSE. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_IS_LOADED fest.

Windows 8 und Windows Server 2012: Dies wird vor Windows 8.1 und Windows Server 2012 R2 nicht unterstützt.

PhysicalDisk

Details zum physischen Datenträger, auf dem sich der virtuelle Datenträger befindet. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_PHYSICAL_DISK fest.

Windows 7 und Windows Server 2008 R2: Dies wird vor Windows 8 und Windows Server 2012 nicht unterstützt.

PhysicalDisk.LogicalSectorSize

Die logische Sektorgröße des physischen Datenträgers.

PhysicalDisk.PhysicalSectorSize

Die physische Sektorgröße des physischen Datenträgers.

PhysicalDisk.IsRemote

Gibt an, ob es sich bei dem physischen Datenträger um einen Remotedatenträger handelt.

VhdPhysicalSectorSize

Die physische Sektorgröße des virtuellen Datenträgers. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_VHD_PHYSICAL_SECTOR_SIZE fest.

Windows 7 und Windows Server 2008 R2: Dies wird vor Windows 8 und Windows Server 2012 nicht unterstützt.

SmallestSafeVirtualSize

Die kleinste sichere Mindestgröße des virtuellen Datenträgers. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_SMALLEST_SAFE_VIRTUAL_SIZE fest.

Windows 7 und Windows Server 2008 R2: Dies wird vor Windows 8 und Windows Server 2012 nicht unterstützt.

FragmentationPercentage

Die Fragmentierungsebene des virtuellen Datenträgers. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_FRAGMENTATION fest.

Windows 7 und Windows Server 2008 R2: Dies wird vor Windows 8 und Windows Server 2012 nicht unterstützt.

VirtualDiskId

Der Bezeichner, der eindeutig erstellt wird, wenn ein Benutzer den virtuellen Datenträger zum ersten Mal erstellt, um diesen virtuellen Datenträger eindeutig zu identifizieren. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID fest.

Windows 8 und Windows Server 2012: Dies wird vor Windows 8.1 und Windows Server 2012 R2 nicht unterstützt.

ChangeTrackingState

Der Status der resilienten Änderungsnachverfolgung (Resilient Change Tracking, RCT) für den virtuellen Datenträger. Legen Sie das Mitglied Version auf GET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE fest.

Windows 8.1 und Windows Server 2012 R2: Dieser Member wird vor Windows 10 und Windows Server 2016 nicht unterstützt.

ChangeTrackingState.Enabled

Gibt an, ob RCT aktiviert ist. TRUE , wenn RCT aktiviert ist; andernfalls FALSE.

ChangeTrackingState.NewerChanges

Gibt an, ob sich der virtuelle Datenträger seit der vom MostRecentId-Member identifizierten Änderung geändert hat. TRUE , wenn sich der virtuelle Datenträger seit der vom MostRecentId-Member identifizierten Änderung geändert hat; andernfalls FALSE.

ChangeTrackingState.MostRecentId[1]

Der Änderungsnachverfolgungsbezeichner für die Änderung, der den Zustand des virtuellen Datenträgers identifiziert, den Sie als Vergleichsgrundlage verwenden möchten, um zu bestimmen, ob das NewerChanges-Mitglied neue Änderungen meldet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Kopfzeile virtdisk.h

Weitere Informationen

Informationen zu VHD

GET_VIRTUAL_DISK_INFO_VERSION

GetVirtualDiskInformation

VHD-Referenz