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
Send comments about this topic to Microsoft
Build date: 4/3/2009