IAMOpenProgress (Compact 2013)

  • Article

3/26/2014

This interface reports the progress of a file-open operation and enables the application to cancel the operation.

When to Implement

Filters that open files over a network can expose this interface to provide download-progress information.

When to Use

An application can use this interface to query the progress of the download, or to cancel the download. If the network is not responsive, a method such as IGraphBuilder::RenderFile might block for an indefinite period. To prevent your application from blocking, create a worker thread that uses IAMOpenProgress to monitor the progress. The worker thread can cancel the operation if a predefined time-out occurs, or in response to a command from the user.

Methods

In addition to the methods inherited from IUnknown, this interface exposes the following methods.

Method

Description

IAMOpenProgress::AbortOperation

Cancels the file-open operation.

IAMOpenProgress::QueryProgress

Retrieves the progress of the file-open operation.

Remarks

The Windows Media Source Filter and File Source (URL) Filter support this interface.

Requirements

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

DirectShow Interfaces