VIRTUAL_DISK_PROGRESS struttura (virtdisk.h)

Contiene i dati di avanzamento e risultato per l'operazione VHD (Virtual Disk) corrente, utilizzata dalla funzione GetVirtualDiskOperationProgress .

Sintassi

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

Members

OperationStatus

Un valore di stato del codice di errore di sistema , questo membro verrà ERROR_IO_PENDING se l'operazione è ancora in corso; in caso contrario, il valore è il codice di risultato dell'operazione completata.

CurrentValue

Stato corrente dell'operazione, usato insieme al membro CompletionValue .

Questo valore è significativo solo se OperationStatus è ERROR_IO_PENDING.

CompletionValue

Valore che il membro CurrentValue sarebbe se l'operazione fosse stata completata.

Questo valore è significativo solo se OperationStatus è ERROR_IO_PENDING.

Commenti

I membri CurrentValue e CompletionValue sono destinati a essere usati per calcolare un valore percentuale e i valori numerici specifici di ognuno non sono significativi in alcun modo. Solo il risultato del calcolo seguente è significativo: CurrentValue diviso da CompletionValue moltiplicato per 100 percentuali di completamento, fino al 100% e incluso il 100% anche quando OperationStatus restituisce ancora ERROR_IO_PENDING. Questa percentuale non è sempre garantita per aumentare con le chiamate successive alla funzione GetVirtualDiskOperationProgress e può diminuire. Queste percentuali ridotte possono essere ignorate in modo sicuro se il rilevamento dello stato è desiderato essere solo in positivo archiviando la percentuale massima corrente.

I membri CurrentValue e CompletionValue possono variare nelle chiamate successive alla funzione GetVirtualDiskOperationProgress , pertanto devono essere usati insieme contemporaneamente dalla stessa chiamata. Non è quindi valido salvarli in locale e quindi eseguire un'altra chiamata alla funzione GetVirtualDiskOperationProgress che prevede l'uso di uno dei valori precedenti con l'altro valore della chiamata più recente.

Il membro OperationStatus è l'indicatore di completamento, non il calcolo completo della percentuale descritto in precedenza. Purché questo membro dati venga restituito con un codice di stato ERROR_IO_PENDING , l'operazione di I/O non è ancora stata completata.

Requisiti

Vedi anche

Informazioni sul disco rigido virtuale

GetVirtualDiskOperationProgress

Informazioni di riferimento sul disco rigido virtuale