estrutura VIRTUAL_DISK_PROGRESS (virtdisk.h)
Contém os dados de progresso e resultado para a operação de VHD (disco rígido virtual) atual, usada pela função GetVirtualDiskOperationProgress .
Sintaxe
typedef struct _VIRTUAL_DISK_PROGRESS {
DWORD OperationStatus;
ULONGLONG CurrentValue;
ULONGLONG CompletionValue;
} VIRTUAL_DISK_PROGRESS, *PVIRTUAL_DISK_PROGRESS;
Membros
OperationStatus
Um código de erro do sistema status valor, esse membro será ERROR_IO_PENDING se a operação ainda estiver em andamento; caso contrário, o valor será o código de resultado da operação concluída.
CurrentValue
O progresso atual da operação, usado em conjunto com o membro CompletionValue .
Esse valor só será significativo se OperationStatus for ERROR_IO_PENDING.
CompletionValue
O valor que o membro CurrentValue seria se a operação fosse concluída.
Esse valor só será significativo se OperationStatus for ERROR_IO_PENDING.
Comentários
Os membros CurrentValue e CompletionValue devem ser usados para calcular um valor percentual e os valores numéricos específicos de cada um não são significativos de forma alguma. Somente o resultado do seguinte cálculo é significativo: CurrentValue dividido por CompletionValue multiplicado por 100% igual a 100% concluído, até e incluindo 100%, mesmo quando OperationStatus ainda está retornando ERROR_IO_PENDING. Essa porcentagem nem sempre é garantida para aumentar com chamadas subsequentes para a função GetVirtualDiskOperationProgress e pode diminuir. Esses percentuais reduzidos poderão ser ignorados com segurança se o acompanhamento de progresso desejar estar apenas no positivo armazenando localmente o percentual máximo atual.
Os membros CurrentValue e CompletionValue podem variar em chamadas subsequentes para a função GetVirtualDiskOperationProgress , portanto, eles devem ser usados juntos ao mesmo tempo da mesma chamada. Ou seja, não é válido salvar nenhum deles localmente e, em seguida, fazer outra chamada para a função GetVirtualDiskOperationProgress esperando usar qualquer um dos valores anteriores com o outro valor da chamada mais recente.
O membro OperationStatus é o indicador de conclusão, não o cálculo de porcentagem concluída descrito anteriormente. Enquanto esse membro de dados estiver retornando com um código de status ERROR_IO_PENDING, a operação de E/S ainda não foi concluída.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 |
| Servidor mínimo com suporte | Windows Server 2008 R2 |
| Cabeçalho | virtdisk.h |