IMediaParamInfo::GetParamText

The GetParamText method retrieves a series of text strings that describe the parameter.

Syntax

HRESULT GetParamText(
    DWORD dwParamIndex,
    WCHAR **ppwchText
);

Parameters

dwParamIndex

[in] Zero-based index of the parameter.

ppwchText

[out] Address of a variable that receives a pointer to a series of Unicode?strings.

Return Values

Returns an HRESULT value. Possible values include the following.

Remarks

If the method succeeds, *ppwchText points to a string with the following format:

Name\0Unit\0Enum1\0Enum2\0...EnumN\0\0

where

• Name is the name of the parameter.
• Unit is the name of the units; for example, milliseconds.
• Enum1 through EnumN are descriptive names for the parameter's enumerated values. (Applies only to parameters of type MPT_ENUM.)

The application can display these values within its user interface. They are not guaranteed to follow a consistent naming scheme. If the user's computer is using an international code page, the method might return a localized string corresponding to that code page.

The object uses the CoTaskMemAlloc function to allocate memory for the string. After you call this method, call CoTaskMemFree to free the buffer.

See Also

• IMediaParamInfo Interface