IWMCodecStrings::GetName method (wmcodecdsp.h)

Retrieves the name of a codec.

Syntax

HRESULT GetName(
  [in]  DMO_MEDIA_TYPE *pmt,
  [in]  ULONG          cchLength,
  [out] LPWSTR         szName,
  [out] ULONG          *pcchLength
);

[in] pmt

Pointer to the output media type. If NULL, the codec will use the media type that is currently set.

[in] cchLength

Size of szName buffer in wide characters.

[out] szName

Address of the wide-character buffer that receives the name. If NULL, pcchLength receives the required length.

[out] pcchLength

Pointer to the required buffer length in wide characters, including the null terminating character.

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	wmcodecdsp.h