ICodecAPI::GetParameterValues

  • Article
 
Microsoft DirectShow 9.0

ICodecAPI::GetParameterValues

The GetParameterValues method returns the list of supported values for a given parameter. This method applies to parameters that support a list of specific values, as opposed to a stepped range of values.

Syntax

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

);

Parameters

Api

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

Values

[out]  Address of a variable that receives a pointer to an array of VARIANT types. The array contains the list of values the encoder supports for this parameter. The caller must free the array by calling the CoTaskMemFree function.

ValuesCount

[out]  Pointer to a variable that receives the number of elements in the array.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
E_INVALIDARG Invalid argument.
S_OK Success.
VFW_E_CODECAPI_LINEAR_RANGE The specified parameter has a linear range, not an enumerated list.

Remarks

This method fails if the codec parameter supports a range of values, rather than a list. If this method fails, try calling ICodecAPI::GetParameterRange.

Requirements

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

Library: Use Strmiids.lib.

See Also