ICeFileFilterSite::ReportProgress

This method is called by a file filter to report the progress of a file conversion.

At a Glance

Header file: Replfilt.h
Windows CE versions: 2.0 and later

Syntax

STDMETHODIMP ICeFileFilterSite::ReportProgress( UINT nPercent );

Parameters

nPercent

Specifies the completed percentage of the operation. For example, if the file filter has converted 25 percent of a file, this parameter should be set to 25.

Return Values

None.

Remarks

Windows CE Services displays a progress bar that indicates the progress of a file conversion, and uses the percentage provided by the filter to set the current position of the progress bar. The filter should periodically call ReportProgress as the conversion progresses.

Consider that updating the progress bar takes a certain amount of time. Therefore, you may want to limit the frequency at which the application calls the ReportProgress method, since calling this method too often can add substantially the actual file copy and conversion time.