estructura de VIRTUAL_DISK_PROGRESS (virtdisk.h)
Contiene los datos de progreso y resultado de la operación actual de disco duro virtual (VHD), que usa la función GetVirtualDiskOperationProgress .
Sintaxis
typedef struct _VIRTUAL_DISK_PROGRESS {
DWORD OperationStatus;
ULONGLONG CurrentValue;
ULONGLONG CompletionValue;
} VIRTUAL_DISK_PROGRESS, *PVIRTUAL_DISK_PROGRESS;
Miembros
OperationStatus
Valor de estado del código de error del sistema , este miembro se ERROR_IO_PENDING si la operación sigue en curso; de lo contrario, el valor es el código de resultado de la operación completada.
CurrentValue
Progreso actual de la operación, que se usa junto con el miembro CompletionValue .
Este valor solo es significativo si OperationStatus está ERROR_IO_PENDING.
CompletionValue
Valor que el miembro CurrentValue sería si se completara la operación.
Este valor solo es significativo si OperationStatus está ERROR_IO_PENDING.
Comentarios
Los miembros CurrentValue y CompletionValue están diseñados para usarse para calcular un valor de porcentaje, y los valores numéricos específicos de cada uno no son significativos de ninguna manera. Solo el resultado del siguiente cálculo es significativo: CurrentValue dividido por CompletionValue multiplicado por 100 es igual al porcentaje completado, hasta el 100 por ciento, incluso cuando OperationStatus sigue devolviendo ERROR_IO_PENDING. Este porcentaje no siempre se garantiza que aumente con llamadas posteriores a la función GetVirtualDiskOperationProgress y puede disminuir. Estos porcentajes reducidos se pueden omitir de forma segura si se desea que el seguimiento de progreso solo esté en el positivo almacenando localmente el porcentaje máximo actual.
Los miembros CurrentValue y CompletionValue pueden variar en las llamadas posteriores a la función GetVirtualDiskOperationProgress , por lo que deben usarse juntos al mismo tiempo desde la misma llamada. Es decir, no es válido guardar ninguno de ellos localmente y, a continuación, realizar otra llamada a la función GetVirtualDiskOperationProgress que espera usar cualquiera de los valores anteriores con el otro valor de la llamada más reciente.
El miembro OperationStatus es el indicador de finalización, no el cálculo de porcentaje completado descrito anteriormente. Siempre que este miembro de datos devuelva con un código de estado de ERROR_IO_PENDING , la operación de E/S aún no se ha completado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Encabezado | virtdisk.h |