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

Confira também

Sobre o VHD

GetVirtualDiskOperationProgress

Referência do VHD