filter Element

Article
4/26/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 filter element contains elements that limit the size of a playlist, duration of a playlist, or number of media items in a playlist.

<filter
    type = "string"
    id = "WPL_GUID"
    name = "string"
>
</filter>

Attributes

type

The type of filter object. There are no predefined values for this attribute.

id (required)

The GUID that uniquely identifies a filter object. The filter object's methods are invoked to interpret the fragment elements contained in the filter element.

Value	Description
{BC5E21B0-504C-46F6-82BF-FB975C911AD6}	The id for the "Microsoft Auto Playlist Filter -- Limits auto playlists by count, size or duration" filter.

name (required)

The name of the filter object.

Value	Description
Microsoft Auto Playlist Filter -- Limits auto playlists by count, size or duration	Limits auto playlists by count, size, or duration.

Parent/Child Elements

Hierarchy	Elements
Parent	smartPlaylist
Child	fragment

Remarks

The filter element does not add any media elements to a playlist; it simply removes or filters out content that was selected by the sourceFilter element.

Examples

<filter 
    type = "smartFilterObject" 
    id = "{BC5E21B0-504C-46F6-82BF-FB975C911AD6}" 
    name = "Microsoft Auto Playlist Filter -- Limits auto playlists by count,size or duration">
        <fragment name = "Limit Number of Items">
            <argument name = "number">25</argument>
        </fragment>
</filter>

Requirements

Requirement	Value
Version	Windows Media Player 9 Series or later.

Partager via