structure VIRTUAL_DISK_PROGRESS (virtdisk.h)
Contient les données de progression et de résultat pour l’opération de disque dur virtuel (VHD) actuelle, utilisée par la fonction GetVirtualDiskOperationProgress .
Syntaxe
typedef struct _VIRTUAL_DISK_PROGRESS {
DWORD OperationStatus;
ULONGLONG CurrentValue;
ULONGLONG CompletionValue;
} VIRTUAL_DISK_PROGRESS, *PVIRTUAL_DISK_PROGRESS;
Membres
OperationStatus
Un code d’erreur système status valeur, ce membre sera ERROR_IO_PENDING si l’opération est toujours en cours ; sinon, la valeur est le code de résultat de l’opération terminée.
CurrentValue
Progression actuelle de l’opération, utilisée conjointement avec le membre CompletionValue .
Cette valeur n’est significative que si OperationStatus est ERROR_IO_PENDING.
CompletionValue
Valeur que le membre CurrentValue serait si l’opération était terminée.
Cette valeur n’est significative que si OperationStatus est ERROR_IO_PENDING.
Remarques
Les membres CurrentValue et CompletionValue sont destinés à être utilisés pour calculer une valeur de pourcentage, et les valeurs numériques spécifiques de chacun d’eux ne sont en aucun cas significatives. Seul le résultat du calcul suivant est significatif : CurrentValue divisé par CompletionValue multiplié par 100 est égal à 100 % complet, jusqu’à 100 % inclus, même si OperationStatus retourne toujours ERROR_IO_PENDING. Ce pourcentage n’est pas toujours garanti pour augmenter avec les appels suivants à la fonction GetVirtualDiskOperationProgress et peut diminuer. Ces pourcentages réduits peuvent être ignorés en toute sécurité si le suivi de la progression est souhaité uniquement dans le positif en stockant localement le pourcentage maximal actuel.
Les membres CurrentValue et CompletionValue peuvent varier dans les appels suivants à la fonction GetVirtualDiskOperationProgress . Ils doivent donc être utilisés simultanément à partir du même appel. Autrement dit, il n’est pas valide d’enregistrer l’une d’elles localement, puis d’effectuer un autre appel à la fonction GetVirtualDiskOperationProgress en s’attendant à utiliser l’une des valeurs précédentes avec l’autre valeur de l’appel plus récent.
Le membre OperationStatus est l’indicateur d’achèvement, et non le calcul de pourcentage complet décrit précédemment. Tant que ce membre de données retourne avec un code ERROR_IO_PENDING status, l’opération d’E/S n’est pas encore terminée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 |
| Serveur minimal pris en charge | Windows Server 2008 R2 |
| En-tête | virtdisk.h |
Voir aussi
À propos du disque dur virtuel