Share via


MSVidWebDVD.CurrentSubpictureStream Property

Note  This topic applies to Windows XP Service Pack 1 or later.

The CurrentSubpictureStream property sets or retrieves the current subpicture stream.

VidWebDVD.CurrentSubpictureStream As Long

Parameters

This property takes no parameters.

Return Value

This property returns a Long indicating the current subpicture stream number. Possible values include the following.

Value Description
0-31 Subpicture stream
63 Muted low-bitrate stream

Error Codes

If the property fails, Err.Number may be set to one of the following values.

Value Description
E_UNEXPECTED Unspecified error.
CO_E_NOTINITIALIZED The graph has not been built.
VFW_E_DVD_INVALIDDOMAIN You attempted to take the value in a domain that does not support this property.
VFW_E_DVD_OPERATION_INHIBITED This user operation is prevented by UOP command.
E_INVALIDARG Invalid stream number entered.

Valid Domains

The following table shows the Annex J command name to which this method name corresponds, and the domains in which this method is valid.

Annex J Command Name Valid Domains
Sub-picture_stream_Change DVD_DOMAIN_VideoManagerMenu

DVD_DOMAIN_VideoTitleSetMenu

DVD_DOMAIN_Title

DVD_DOMAIN_Stop

Remarks

This property is read/write and defaults to 0 (zero). Before setting a new subpicture stream, call IsSubpictureStreamEnabled to verify that the stream is available.

Setting this property causes the SubpictureOn property to toggle to True.

Examples

' Setting the property.
VidWebDVD.CurrentSubpictureStream = lNewStream
' Returning the property.
lCurrStream = VidWebDVD.CurrentSubpictureStream

Requirements

Type Library Use MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library.
DLL Requires Quartz.dll.

See Also

MSVidWebDVD Object
Subpicture Streams: Controlling Subtitles

Send comments about this topic to Microsoft

Build date: 12/4/2008