IltmmDVDTitle::GetSubpictureStream

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDTitle__getSubpictureStream(pDVDTitle, Index, pVal)

C++ Syntax

HRESULT GetSubpictureStream(Index, pVal)

 

IltmmDVDTitle *pDVDTitle;

/* pointer to an interface */

long Index;

/* index */

IltmmDVDSubpictureStream * * pVal;

/* pointer to a pointer to an interface */

Gets a specific subpicture stream interface from the title The name for a group of related video files (called "Chapters") on your DVD. For example, for a DVD called "My Summer Vacation," you might have the titles "Water Skiing," "New Friends," and "Hiking." For each of those titles, you might have one or more different video files..

Parameter

Description

pDVDTitle

Pointer to an IltmmDVDTitle interface.

Index

Index for a specific subpicture stream.

pVal

Pointer to a variable that receives the IltmmDVDSubpictureStream interface pointer for the subpicture stream at the specified zero-based index.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This method will return the specified subpicture stream interface in the title. To get number of subpicture streams in the title, call IltmmDVDTitle::get_SubpictureStreamCount property.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

IltmmDVDTitle::get_SubpictureStreamCount, IltmmDVDTitle::get_SelectedSubpictureStream, IltmmDVDTitle::put_SelectedSubpictureStream

Topics:

Multimedia Function Group

Example

For C example, refer to DVD Source Example.

For C++ example, refer to DVD Source Example.