IWMPMedia::getItemInfoByAtom method

Article
06/20/2023

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

The getItemInfoByAtom method returns the value of the attribute with the specified index number.

Syntax

public System.String getItemInfoByAtom(
  System.Int32 lAtom
);


Public Function getItemInfoByAtom( _
  ByVal lAtom As System.Int32 _
) As System.String
Implements IWMPMedia.getItemInfoByAtom

Parameters

lAtom [in]: A System.Int32 that specifies the index at which the requested attribute resides within the set of available attributes.

Return value

A System.String that is the value of the attribute.

Remarks

This method can be used to retrieve metadata for a specific media item by using an attribute index number. The attributeCount property can be used to determine the number of attributes available for the media item.

The getMediaAtom method of the IWMPMediaCollection interface can also be used to retrieve the index of a particular attribute. This technique is generally more efficient than the getItemInfo or getItemInfoByType methods when working with large playlists.

Before calling this method, you must have read access to the library. For more information, see Library Access.

Requirements

Requirement	Value
Version	Windows Media Player 9 Series or later
Namespace	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)