IDvdInfo::GetCurrentSubpicture
Microsoft DirectShow 9.0 |
IDvdInfo::GetCurrentSubpicture
- Note The IDvdInfo interface is deprecated. Use IDvdInfo2 instead.
Retrieves the number of available subpicture streams, the currently selected subpicture stream number, and whether the subpicture display is disabled.
Syntax
HRESULT GetCurrentSubpicture( ULONG *pnStreamsAvailable, ULONG *pnCurrentStream, BOOL *pIsDisabled );
Parameters
pnStreamsAvailable
[out] Pointer to the retrieved number of available subpicture streams.
pnCurrentStream
[out] Pointer to the retrieved number of the currently selected subpicture stream.
pIsDisabled
[out] Pointer to a value indicating whether the subpicture display is disabled.
Return Value
Returns an HRESULT value .
Return code | Description |
E_UNEXPECTED | DVD is not initialized or domain is not DVD_DOMAIN_Title. |
S_OK | Success. |
VFW_E_DVD_INVALIDDOMAIN | Requested action is not supported on this domain (DVD_DOMAIN). |
VFW_E_DVD_OPERATION_INHIBITED | Requested action cannot occur at this point in the movie due to the authoring of the current DVD-Video disc. |
Remarks
Subpicture streams authored as forcedly activated streams will be displayed even if the application has disabled subpicture display with the IDvdControl::SubpictureStreamChange method.
This method returns an error unless the domain is DVD_DOMAIN_Title. For more information, see DVD_DOMAIN.
Requirements
Reference: Dshow.h.
Library: Quartz.dll.
See Also