Export (0) Print
Expand All

ITIMEMediaElement::player Property

This topic documents a feature of HTML+TIME 2.0, which is obsolete as of Windows Internet Explorer 9.

Sets or gets the object used to render the media associated with this element.

Syntax


HRESULT ITIMEMediaElement::get_player(BSTR sID);HRESULT ITIMEMediaElement::put_player(BSTR sID);

Parameters

sID
BSTR that specifies one of the values listed in Possible Values.
sID
BSTR that specifies one of the values listed in Possible Values.

Possible Values

DMusic No longer supported. The Microsoft DirectMusic player.
DVD The digital video disc (DVD) movie player.
Class ID The class identifier of the object used to render the element's media. The format is "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}" for registered Microsoft ActiveX controls. For example, use "{22d6f312-b0f6-11d0-94ab-0080c74c7e95}" for the Microsoft Windows Media Player control.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This property works only with media-playing objects that support HTML+TIME (Timed Interactive Multimedia Extensions). This property cannot be modified in script after the HTMLWindowEvents::onload event fires on the document body.

As of Microsoft Internet Explorer 6, authors can use HTML+TIME with the mediaBar behavior to play timed content in the Media Bar. The Media Bar content proxy player is provided to ensure that the ITIMEState::activeTime of an HTML+TIME timeline is coordinated with the ITIMEState::activeTime that is used by the Media Bar player control. To coordinate media playing in the Media Bar with an HTML+TIME timeline playing in the Media Bar content area, specify the class identifier of the Media Bar content proxy player in the PLAYER attribute of the t:MEDIA element. " {52ca3bcf-3b9b-419e-a3d6-5d28c0b0b50c}" is the content proxy class identifier.

Note  The DirectMusic  HTML control and the DirectMusic TIME control are turned off by default in Windows 2000  Service Pack 4 (SP4), Windows XP  Service Pack 1 (SP1), Windows Server 2003, and later. Therefore, the DirectMusic  API should no longer be referenced by this property.

See Also

Community Additions

ADD
Show:
© 2014 Microsoft