IDvdControl::SetRoot method (strmif.h)

Article
02/22/2024

[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.]

Note The IDvdControl interface is deprecated. Use IDvdControl2 instread.

Sets the root directory containing the DVD-Video volume.

Syntax

HRESULT SetRoot(
  [in] LPCWSTR pszPath
);

Parameters

[in] pszPath

Pointer to the directory name to set as the root directory.

Return value

Returns an HRESULT value.

Remarks

This method returns an error unless the domain is DVD_DOMAIN_Stop. For more information, see DVD_DOMAIN.

If you haven't set the root directory before calling IDvdControl::TitlePlay, the first drive starting from C: that contains a VIDEO_TS directory in the top level directory will be used as the root.

Requirements

Requirement	Value
Target Platform	Windows
Header	strmif.h (include Dshow.h)