IltmmDVDControl::get_CurrentChapter
#include "ltmm.h"
C Syntax |
HRESULT IltmmDVDControl__get_CurrentChapter(pDVD, pChapter) |
C++ Syntax |
HRESULT get_CurrentChapter(pChapter) |
IltmmDVDControl *pDVD; |
/* pointer to an interface */ |
long *pChapter; |
/* pointer to a variable */ |
Retrieves the current chapter The name for each individual video file on a DVD. For example, under the title "Water Skiing", you might have the chapters "My first try," "My first wreck," and "My first jump.".
Parameter |
Description |
pDVD |
Pointer to an IltmmDVDControl interface. |
pChapter |
Pointer to a variable that receives the current chapter number. |
Returns
S_OK |
The function ran successfully. |
<> S_OK |
An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation. |
Comments
Call IltmmDVDControl::GetNumberOfChapters to retrieve the number of available chapters within a 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..
Call IltmmDVDControl::PlayChapter to select and play a specific chapter within a title.
To retrieve other "current" information, use the following functions:
IltmmDVDControl::get_CurrentTitle
IltmmDVDControl::get_CurrentDiscSide
IltmmDVDControl::get_CurrentTime
IltmmDVDControl::get_CurrentVolume
IltmmDVDControl::get_CurrentButton
IltmmDVDControl::get_CurrentAngle
IltmmDVDControl::get_CurrentUOPS
IltmmDVDControl::get_CurrentAudioStream
IltmmDVDControl::get_CurrentSubpictureStream
IltmmDVDControl::get_CurrentDomain
For more detailed information, refer to the Microsoft documentation for IDvdInfo2::GetCurrentFolder at http://msdn.microsoft.com/archive/default.asp?url=/library/en-us/directshow/htm/idvdinfo2getcurrentlocation.asp.
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
Example
For a C example, refer to IltmmDVDControl::GetButtonAtPosition Example for C.
For a C++ example, refer to IltmmDVDControl::GetButtonAtPosition Example for C++.