| Microsoft DirectX 9.0 |
The SelectSubpictureStream method sets the subpicture stream to display.
Syntax
HRESULT SelectSubpictureStream(
ULONG ulSubPicture,
DWORD dwFlags,
IDvdCmd **ppCmd
);
Parameters
ulSubPicture
Value that specifies the subpicture stream, which must be from 0 through 31, or 63.
| Return code | Description |
| 0-31 | The stream is valid. |
| 63 | The stream is the dummy stream, which means it is a muted, low-bitrate stream. |
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. |
| E_INVALIDARG | ulSubPicture is out of range or doesn't correspond to an SP stream. |
| E_UNEXPECTED | The ulSubPicture parameter is valid, but DVD Navigator cannot set it for some other reason. |
| VFW_E_DVD_OPERATION_INHIBITED | UOP control prohibits the operation. |
| VFW_E_DVD_INVALIDDOMAIN | Invalid domain. |
| VFW_E_DVD_STREAM_DISABLED | The specified stream is disabled. |
Remarks
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