Share via


IWMLanguageList interface (wmsdkidl.h)

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IWMLanguageList interface manages a list of languages supported by an ASF file. This interface supports both content and metadata in multiple languages.

The IWMLanguageList interface is supported in the profile, writer, metadata editor, reader, and synchronous reader objects. A pointer to an instance of IWMLanguageList can be obtained by calling the QueryInterface method of any interface in one of the listed objects.

Important  Do not use this interface before opening the reader object.
 

Inheritance

The IWMLanguageList interface inherits from the IUnknown interface. IWMLanguageList also has these types of members:

Methods

The IWMLanguageList interface has these methods.

 
IWMLanguageList::AddLanguageByRFC1766String

The AddLanguageByRFC1766String method adds an entry to the list of supported languages for a file based upon a language tag compliant with RFC 1766.
IWMLanguageList::GetLanguageCount

The GetLanguageCount method retrieves the total number of supported languages in the language list.
IWMLanguageList::GetLanguageDetails

The GetLanguageDetails method retrieves the RFC 1766-compliant language tag for an entry in the list of supported languages.

Remarks

This interface provides support for referencing languages by a string compliant with RFC 1766 – Tags for the Identification of Languages. Other interfaces in this SDK refer to the languages supported in an ASF file by language index. A language index is assigned to every language added to the language list.

This interface manages the list of languages supported for the file. Individual features of the file may not support all of the languages in the list. When selecting a language for playback of an output associated with a set of streams that are mutually exclusive by language, you must get the languages that are supported in that mutual exclusion object. You can retrieve the languages supported for a particular output by using the methods of the IWMReaderAdvanced4 interface.

When using this interface to add metadata in multiple languages to an MP3 file, only the first half of the language string is important. For example, the RFC 1766 identifier "en-us" designates English in the region of the United States. When written to an MP3 file, the identifier would be "en" without a regional designation.

For a list of common RFC 1766-compliant language identifiers, see Language Strings.

Requirements

Requirement Value
Target Platform Windows
Header wmsdkidl.h

See also

Interfaces

Metadata Editor Object

Profile Object

Reader Object

Synchronous Reader Object

Writer Object