struktur VIRTUAL_DISK_PROGRESS (virtdisk.h)

Berisi kemajuan dan data hasil untuk operasi hard disk virtual (VHD) saat ini, yang digunakan oleh fungsi GetVirtualDiskOperationProgress .

Sintaks

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

Anggota

OperationStatus

Nilai status kode kesalahan sistem , anggota ini akan ERROR_IO_PENDING jika operasi masih berlangsung; jika tidak, nilainya adalah kode hasil dari operasi yang selesai.

CurrentValue

Kemajuan operasi saat ini, digunakan bersama dengan anggota CompletionValue .

Nilai ini bermakna hanya jika OperationStatusERROR_IO_PENDING.

CompletionValue

Nilai yang akan menjadi anggota CurrentValue jika operasi selesai.

Nilai ini bermakna hanya jika OperationStatusERROR_IO_PENDING.

Keterangan

Anggota CurrentValue dan CompletionValue dimaksudkan untuk digunakan untuk menghitung nilai persentase, dan nilai numerik tertentu dari masing-masing tidak signifikan dengan cara apa pun. Hanya hasil perhitungan berikut yang bermakna: CurrentValue dibagi dengan CompletionValue dikalikan 100 sama dengan persentase selesai, hingga dan termasuk 100 persen, bahkan ketika OperationStatus masih mengembalikan ERROR_IO_PENDING. Persentase ini tidak selalu dijamin meningkat dengan panggilan berikutnya ke fungsi GetVirtualDiskOperationProgress , dan dapat berkurang. Persentase yang menurun ini dapat diabaikan dengan aman jika pelacakan kemajuan diinginkan hanya di positif dengan menyimpan persentase maksimum saat ini secara lokal.

Anggota CurrentValue dan CompletionValue dapat bervariasi dalam panggilan berikutnya ke fungsi GetVirtualDiskOperationProgress , sehingga mereka harus digunakan bersama-sama pada saat yang sama dari panggilan yang sama. Artinya, tidak valid untuk menyimpan salah satunya secara lokal dan kemudian melakukan panggilan lain ke fungsi GetVirtualDiskOperationProgress yang mengharapkan untuk menggunakan salah satu nilai sebelumnya dengan nilai lain dari panggilan yang lebih baru.

Anggota OperationStatus adalah indikator penyelesaian, bukan perhitungan persen lengkap yang dijelaskan sebelumnya. Selama anggota data ini kembali dengan kode status ERROR_IO_PENDING , operasi I/O belum selesai.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7
Server minimum yang didukung	Windows Server 2008 R2
Header	virtdisk.h

Lihat juga

Tentang VHD

GetVirtualDiskOperationProgress

Referensi VHD