Share via

IEncoderAPI::GetParameterValues

  • Article
 
Microsoft DirectShow 9.0

IEncoderAPI::GetParameterValues

  • Note   The IEncoderAPI interface is deprecated. Use ICodecAPI instead.

The GetParameterValues method retrieves the list of values supported by the given parameter.

Syntax

  HRESULT GetParameterValues(
  const GUID*  Api,
  VARIANT**  Values
  ULONG*  ValuesCount,

);

Parameters

Api

[in]  Pointer to a GUID that specifies the parameter.

Values

[out, size_is(*ValuesCount)]  Address of a pointer to an array that receives the values.

ValuesCount

[out]  Indicates the number of entries placed into the array.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Remarks

This method returns an array of VARIANT types representing the individual values supported by the parameter.  This array is allocated by the callee through CoTaskMemAlloc ** and placed into the Values parameter. On exit, ValuesCount contains the number of elements in the array. The caller must free the array by calling CoTaskMemFree.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also