#include "ltmm.h"
C Syntax |
HRESULT IltmmDVDControl_get_CurrentVolume(pDVD, pVolume) |
C++ Syntax |
HRESULT get_CurrentVolume(pVolume) |
IltmmDVDControl *pDVD; |
/* pointer to an interface */ |
long *pVolume; |
/* pointer to a variable */ |
Retrieves the current DVD volume.
Parameter |
Description |
pDVD |
Pointer to an IltmmDVDControl interface. |
pVolume |
Pointer to a variable that receives the volume number for the root directory. |
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
Each DVD disc has a single volume number, assigned to it by the manufacturer, that identifies a disc's position in a multi-disc DVD set. For example, the programmer can implement code in a DVD playback routine, called when playing a multi-disc movie, that checks the DVD's volume number to ensure that the end user does not insert the discs out of order.
To retrieve other "current" information, use the following functions:
IltmmDVDControl::get_CurrentTitle
IltmmDVDControl::get_CurrentChapter
IltmmDVDControl::get_CurrentDiscSide
IltmmDVDControl::get_CurrentTime
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::GetDVDVolumeInfo.
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. |
Win32, x64
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++.