Microsoft DirectX 8.0

IAMCopyCaptureFileProgress Interface

The IAMCopyCaptureFileProgress interface contains one method, Progress, which the ICaptureGraphBuilder::CopyCaptureFile method can call to receive information on the progress of a copy operation.

Capture applications can implement this interface to receive information on the percentage complete of the copy operation on the capture file. If an application does not need to receive this information, there is no need to implement the interface.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IAMCopyCaptureFileProgress methodsDescription
Progress Called periodically by the ICaptureGraphBuilder::CopyCaptureFile method during capture operations.

IAMCopyCaptureFileProgress::Progress

IAMCopyCaptureFileProgress Interface

Called periodically by the ICaptureGraphBuilder::CopyCaptureFile method during capture operations.

Syntax

HRESULT Progress(
  int iProgress
  );

Parameters

iProgress
[in] Integer between 0 and 100 specifying the percentage of the copy operation that has completed.

Return Value

Return S_OK if successful or S_FALSE if the operation is aborted.

Remarks

Applications typically use the value of iProgress to update a progress bar on the user interface.