Collapse All Expand All

IltmfConvert::get_PercentCompleteScalar

#include "ltmf.h"

C Syntax	HRESULT IltmfConvert_get_PercentCompleteScalar(pVal)
C++ Syntax	HRESULT get_PercentCompleteScalar(pVal)

 

long *pVal;

/* pointer to a variable */

Retrieves the scalar value by which to divide the current conversion completion percentage.

Parameter	Description
pVal	Pointer to a variable that receives the scalar value.

Returns

S_OK	The function ran successfully.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the MediaFoundation documentation.

Comments

The programmer retrieves the current conversion completion percentage value by calling IltmfConvert::get_PercentComplete. He or she then divides the percentage complete by the percent complete scalar value to determine the actual percentage complete. For example, if the scalar value is 100 and a call to IltmfConvert::get_PercentComplete retrieves a value of 50, then the process is 50/100 complete (0.5%) instead of 50%. Likewise, if the scalar is 1 and the programmer gets a percent complete value of 50, then the percentage complete is 50/1, or 50% complete.

Call IltmfConvert::put_PercentCompleteScalar to set the percentage complete scalar.

Required DLLs and Libraries

LTMF 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:	IltmfConvert interface, IltmfConvert::Put_PercentCompleteScalar, IltmfConvert::get_PercentComplete
Topics:	Media Foundation Function Group

Example

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