VIRTUAL_DISK_PROGRESS 結構 (virtdisk.h)

包含目前虛擬硬碟 (VHD) 作業的進度和結果數據，由 GetVirtualDiskOperationProgress 函式使用。

語法

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

成員

OperationStatus

系統錯誤碼狀態值，如果作業仍在進行中，此成員將會ERROR_IO_PENDING;否則，此值是已完成作業的結果碼。

CurrentValue

作業的目前進度，與 CompletionValue 成員搭配使用。

只有在 OperationStatusERROR_IO_PENDING時，這個值才有意義。

CompletionValue

當作業完成時 ，CurrentValue 成員會是的值。

只有在 OperationStatusERROR_IO_PENDING時，這個值才有意義。

備註

CurrentValue 和 CompletionValue 成員是用來計算百分比值，而且每個成員的特定數值不會以任何方式顯著。 只有下列計算的結果有意義：CurrentValue 除以 CompletionValue 乘以 100 等於完成百分比，最多包含 100%，即使 OperationStatus 仍然傳回ERROR_IO_PENDING也一樣。 此百分比不一定會隨著 GetVirtualDiskOperationProgress 函式的後續呼叫而增加，而且可能會減少。 如果預期進度追蹤只在本機儲存目前最大百分比，這些減少的百分比可能會安全地忽略。

CurrentValue 和 CompletionValue 成員在 GetVirtualDiskOperationProgress 函式的後續呼叫中可能會有所不同，因此必須同時從相同的呼叫同時使用它們。 也就是說，將任一個值儲存在本機，然後對 GetVirtualDiskOperationProgress 函式進行另一個呼叫，預期會使用上述其中一個值搭配較新呼叫的其他值。

OperationStatus 成員是完成的指標，而不是先前所述的完成百分比計算。 只要此數據成員以 ERROR_IO_PENDING 狀態代碼傳回，I/O 作業尚未完成。

規格需求

另請參閱

關於 VHD

GetVirtualDiskOperationProgress

VHD 參考