IDvdInfo2::IsSubpictureStreamEnabled
Microsoft DirectShow 9.0 |
IDvdInfo2::IsSubpictureStreamEnabled
The IsSubpictureStreamEnabled method determines if the specified subpicture stream is enabled in the current title.
Syntax
HRESULT IsSubpictureStreamEnabled( ULONG ulStreamNum, BOOL *pbEnabled );
Parameters
ulStreamNum
[in] Subpicture stream number to test.
pbEnabled
[out] Pointer to a variable of type BOOL that receives a value of TRUE if the audio stream is enabled, or FALSE otherwise.
Return Values
Returns one of the following HRESULT values.
Return code | Description |
S_OK | Success. |
E_INVALIDARG | Invalid argument. |
E_UNEXPECTED | The DVD Navigator is not initialized. |
Remarks
A DVD can have up to 32 separate subpicture streams, although typically not all the streams will be enabled for each title. Use IsSubpictureStreamEnabled to determine whether a particular stream is enabled for the current title, and then call IDvdControl2::SelectSubpictureStream to select one of the enabled streams.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also