Microsoft DirectX 8.1 (C++)

IDvdInfo::GetCurrentSubpicture

Note   The IDvdInfo interface is deprecated.

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.

See Also