VIRTUAL_DISK_PROGRESS 구조체(virtdisk.h)
GetVirtualDiskOperationProgress 함수에서 사용하는 현재 VHD(가상 하드 디스크) 작업에 대한 진행률 및 결과 데이터를 포함합니다.
구문
typedef struct _VIRTUAL_DISK_PROGRESS {
DWORD OperationStatus;
ULONGLONG CurrentValue;
ULONGLONG CompletionValue;
} VIRTUAL_DISK_PROGRESS, *PVIRTUAL_DISK_PROGRESS;
멤버
OperationStatus
시스템 오류 코드 상태 값이면 작업이 계속 진행 중인 경우 이 멤버가 ERROR_IO_PENDING. 그렇지 않으면 값이 완료된 작업의 결과 코드입니다.
CurrentValue
CompletionValue 멤버와 함께 사용되는 작업의 현재 진행률입니다.
이 값은 OperationStatus 가 ERROR_IO_PENDING 경우에만 의미가 있습니다.
CompletionValue
작업이 완료된 경우 CurrentValue 멤버가 되는 값입니다.
이 값은 OperationStatus 가 ERROR_IO_PENDING 경우에만 의미가 있습니다.
설명
CurrentValue 및 CompletionValue 멤버는 백분율 값을 계산하는 데 사용되며 각 멤버의 특정 숫자 값은 어떤 방식으로든 중요하지 않습니다. 다음 계산의 결과만 의미가 있습니다. CurrentValue 를 CompletionValue 로 곱한 값은 OperationStatus 가 여전히 ERROR_IO_PENDING 반환하는 경우에도 최대 100%까지 완료율과 같습니다. 이 백분율은 GetVirtualDiskOperationProgress 함수에 대한 후속 호출로 항상 증가하도록 보장되지 않으며 감소할 수 있습니다. 이러한 감소된 백분율은 현재 최대 백분율을 로컬로 저장하여 진행률 추적이 양수로만 유지되도록 하려는 경우 안전하게 무시될 수 있습니다.
CurrentValue 및 CompletionValue 멤버는 GetVirtualDiskOperationProgress 함수에 대한 후속 호출에서 다를 수 있으므로 동일한 호출에서 동시에 함께 사용해야 합니다. 즉, 두 값 중 하나를 로컬로 저장한 다음 GetVirtualDiskOperationProgress 함수를 다시 호출하여 이전 값 중 하나를 최신 호출의 다른 값과 함께 사용할 것으로 예상하는 것은 유효하지 않습니다.
OperationStatus 멤버는 이전에 설명한 완료율 계산이 아니라 완료의 표시기입니다. 이 데이터 멤버가 ERROR_IO_PENDING 상태 코드와 함께 반환하는 한 I/O 작업은 아직 완료되지 않았습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 |
| 지원되는 최소 서버 | Windows Server 2008 R2 |
| 머리글 | virtdisk.h |