DirectShow Animated Header -- IAMCopyCaptureFileProgress Interface DirectShow Animated Header -- IAMCopyCaptureFileProgress Interface* Microsoft DirectShow SDK
*Index  *Topic Contents
*Previous Topic: IAMCollection Interface
*Next Topic: IAMCrossbar Interface

IAMCopyCaptureFileProgress Interface


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

When to Implement

Capture applications implement this method when they need to receive information on the percentage complete of a copy operation.

When to Use

Use this interface when applications need to check the copying progress of a captured file.

Methods in Vtable Order
IUnknown methods Description
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IAMCopyCaptureFileProgress methods Description
Progress Sends applications the progress (percentage complete) of a copy operation that the ICaptureGraphBuilder::CopyCaptureFile method is performing.


IAMCopyCaptureFileProgress::Progress

IAMCopyCaptureFileProgress Interface

Sends applications the progress (percentage complete) of a copy operation that the ICaptureGraphBuilder::CopyCaptureFile method is performing.

HRESULT Progress(
  int iProgress
  );

Parameters
iProgress
[in] Percentage of copy complete between 0 and 100.
Return Values

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

Remarks

The ICaptureGraphBuilder::CopyCaptureFile can call this method to inform applications of the copy operation's progress.

This method is called periodically while ICaptureGraphBuilder::CopyCaptureFile is running.

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.

*Top of Page