VIRTUAL_DISK_PROGRESS-Struktur (virtdisk.h)

Enthält die Status- und Ergebnisdaten für den aktuellen VHD-Vorgang (Virtual Hard Disk), der von der GetVirtualDiskOperationProgress-Funktion verwendet wird.

Syntax

typedef struct _VIRTUAL_DISK_PROGRESS {
  DWORD     OperationStatus;
  ULONGLONG CurrentValue;
  ULONGLONG CompletionValue;
} VIRTUAL_DISK_PROGRESS, *PVIRTUAL_DISK_PROGRESS;

Member

OperationStatus

Ein Systemfehlercode status Wert. Dieser Member wird ERROR_IO_PENDING, wenn der Vorgang noch ausgeführt wird. Andernfalls ist der Wert der Ergebniscode des abgeschlossenen Vorgangs.

CurrentValue

Der aktuelle Status des Vorgangs, der in Verbindung mit dem CompletionValue-Element verwendet wird.

Dieser Wert ist nur dann von Bedeutung, wenn OperationStatusERROR_IO_PENDING ist.

CompletionValue

Der Wert, der das CurrentValue-Element wäre, wenn der Vorgang abgeschlossen wäre.

Dieser Wert ist nur dann von Bedeutung, wenn OperationStatusERROR_IO_PENDING ist.

Hinweise

Die Elemente CurrentValue und CompletionValue sollen zum Berechnen eines Prozentwerts verwendet werden, und die jeweiligen numerischen Werte sind in keiner Weise signifikant. Nur das Ergebnis der folgenden Berechnung ist aussagekräftig: CurrentValue dividiert durch CompletionValue multipliziert mit 100 entspricht %abgeschlossen, bis einschließlich 100 %, auch wenn OperationStatus noch ERROR_IO_PENDING zurückgibt. Dieser Prozentsatz wird bei nachfolgenden Aufrufen der GetVirtualDiskOperationProgress-Funktion nicht immer erhöht und kann verringert werden. Diese verringerten Prozentsätze können sicher ignoriert werden, wenn die Fortschrittsnachverfolgung durch lokales Speichern des aktuellen maximalen Prozentsatzes nur positiv sein soll.

Die Elemente CurrentValue und CompletionValue können in nachfolgenden Aufrufen der GetVirtualDiskOperationProgress-Funktion variieren, sodass sie gleichzeitig vom gleichen Aufruf verwendet werden müssen. Das heißt, es ist nicht gültig, sie lokal zu speichern und dann einen weiteren Aufruf der GetVirtualDiskOperationProgress-Funktion auszuführen, die erwartet, dass sie einen der vorherigen Werte mit dem anderen Wert aus dem neueren Aufruf verwenden wird.

Das OperationStatus-Element ist der Abschlussindikator, nicht die zuvor beschriebene Berechnung in Prozent abgeschlossen. Solange dieser Datenmember mit einem ERROR_IO_PENDING status Code zurückgegeben wird, ist der E/A-Vorgang noch nicht abgeschlossen.

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

GetVirtualDiskOperationProgress

VHD-Referenz