| Microsoft DirectX 9.0 |
The SetSubpictureState method turns the subpicture display on or off.
Syntax
HRESULT SetSubpictureState(
BOOL bState,
DWORD dwFlags,
IDvdCmd **ppCmd
);
Parameters
bState
[in] Boolean value that specifies whether the subpicture display is on; TRUE sets subpicture display on for subsequent playback.
dwFlags
[in] Bit flag that contains one or more DVD_CMD_FLAGS enumeration specifying command synchronization options.
ppCmd
[out] Address of a pointer to an IDvdCmd object that can be used to synchronize DVD commands.
Return Values
Returns one of the following values.
| Return code | Description |
| S_OK | Success. |
| VFW_E_DVD_INVALIDDOMAIN | The DVD Navigator is in the First Play domain. |
| VFW_E_DVD_OPERATION_INHIBITED | UOP control prohibits the operation. |
Remarks
Subpicture streams are typically used in menus for button text and sometimes button graphics, and in video playback for subtitles, credits, or other overlaid graphics. Do not confuse subpictures with closed captions; the latter are encoded within the video stream. In general, this method is intended for controlling subpicture display over video while the DVD Navigator filter is playing video in the DVD Title domain.
This method corresponds to the second parameter of the Annex J "Sub-picture_Stream_Change" command.
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 |
See Also