IltmmConvert::put_PercentCompleteScalar

#include "ltmm.h"

C Syntax

HRESULT IltmmConvert_put_PercentCompleteScalar (newVal)

C++ Syntax

HRESULT put_PercentCompleteScalar(newVal)

 

long newVal;

/* percent complete scalar*/

Sets the scalar value to be multiplied by the current conversion completion percentage.

Parameter

Description

newVal

The new scalar value to set.

Returns

S_OK

The function ran successfully.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Call IltmmConvert::get_PercentCompleteScalar to retrieve the current scalar value.

Using a value other than one will have the effect of changing the range of progress notification; for example, setting this property to 5 will change the progress range from "0 to 100" to "0 to 500".

To retrieve the current conversion completion percentage value, call IltmmConvert::get_PercentComplete.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Elements:

IltmmConvert interface, IltmmConvert::get_PercentCompleteScalar, IltmmConvert::get_PercentComplete

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmConvert::get_PercentCompleteScalar Example for C.

For a C++ example, refer to IltmmConvert::get_PercentCompleteScalar Example for C++.