IDvdInfo2::GetDVDVolumeInfo method (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The GetDVDVolumeInfo method retrieves the current DVD volume information.
Syntax
HRESULT GetDVDVolumeInfo(
[out] ULONG *pulNumOfVolumes,
[out] ULONG *pulVolume,
[out] DVD_DISC_SIDE *pSide,
[out] ULONG *pulNumOfTitles
);
Parameters
[out] pulNumOfVolumes
Receives the number of volumes in the volume set.
[out] pulVolume
Receives the volume number for this root directory.
[out] pSide
Pointer to a variable of type DVD_DISC_SIDE that receives the current disc side.
[out] pulNumOfTitles
Pointer to a variable of type ULONG that receives the number of titles available in this volume.
Return value
Returns one of the following HRESULT values.
| Return code | Description |
|---|---|
|
Success. |
|
Invalid argument. |
Remarks
Some discs can be distributed as part of multidisc set. "Volume" in this context can mean either "disc" or "disc side", depending on how the disc was authored.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |
| Library | Strmiids.lib |