IEncoderAPI::GetParameterValues method (strmif.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

[IEncoderAPI is no longer available for use. Instead, use ICodecAPI.]

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

Syntax

HRESULT GetParameterValues(
  [in]  const GUID *Api,
  [out] VARIANT    **Values,
  [out] ULONG      *ValuesCount
);

Parameters

[in] Api

Pointer to a GUID that specifies the parameter.

[out] Values

Address of a pointer to an array that receives the values.

[out] ValuesCount

Indicates the number of entries placed into the array.

Return value

If this method succeeds, it returns S_OK. Otherwise, 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

Requirement Value
Target Platform Windows
Header strmif.h (include Dshow.h)
Library Strmiids.lib

See also

Encoder API

IEncoderAPI Interface