ITIMEMediaElement::src Property

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

Sets or gets the source URL of the media.

Syntax


HRESULT ITIMEMediaElement::get_src(BSTR sURL);HRESULT ITIMEMediaElement::put_src(BSTR sURL);

Parameters

sURL
A BSTR that specifies the URL of the media. If the URL has the keyword #sami as a suffix, it includes a .smi file type or a .sami file type for media captioning.
sURL
A BSTR that specifies the URL of the media. If the URL has the keyword #sami as a suffix, it includes a .smi file type or a .sami file type for media captioning.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This property is read-only when applied to the playItem object.

HTML+TIME (Timed Interactive Multimedia Extensions) 2.0 supports media that includes captioning stream technology, called Synchronized Accessible Media Interchange (SAMI). The SRC attribute of a media element can use the #sami suffix to include captioning with media playback. For more information, see Adding Closed Captions to Digital Media and Understanding SAMI 1.0.

security note Security Alert  When the #sami suffix is specified with a valid URL for the SRC attribute of a media element, the contents of the SAMI stream display as text in that element. Likewise, the stream contents can be returned as the IHTMLElement::innerText of that element. For security reasons, developers should regard the SAMI stream as user input and take routine precautions against displaying unconfirmed user input as HTML instead of text. For more information, see Security Considerations: Dynamic HTML and Security Considerations: DHTML and Default Behaviors.

See Also

Introduction to HTML+TIME

Community Additions

ADD
Show:
© 2014 Microsoft