IMFPMediaItem::CanHaveMultipleEntries Method

[This documentation is preliminary and is subject to change.]
Queries whether the media item represents a playlist. A playlist might contain more than one entry.

Syntax

HRESULT CanHaveMultipleEntries(
  [out]  BOOL *pfCanHaveMultipleEntries
);

Parameters

  • pfCanHaveMultipleEntries [out]
    Receives the value TRUE if the media item represents a playlist. Otherwise, receives the value FALSE.

Return Value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

By default, the player object plays each entry in a playlist. Two events are associated with playlist entries:

  • Before a new entry starts, the player object sends an MFP_EVENT_TYPE_CONFIGURE_PENDING_INTRA_MEDIAITEM_ENTRY event. You can use this event to cancel playback of that entry. For more information, see MFP_CONFIGURE_PENDING_INTRA_MEDIAITEM_ENTRY_EVENT.
  • After playback switches to the next entry, the player object sends an MFP_EVENT_TYPE_TRANSITIONED_INTRA_MEDIAITEM_ENTRIES event.

Requirements

Client Requires Windows 7.
Header Declared in Mfplay.h.

See Also

IMFPMediaItem

Send comments about this topic to Microsoft

Build date: 4/3/2009