Метод IDvdControl::SetRoot (strmif.h)

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Примечание Интерфейс IDvdControl является устаревшим. Используйте IDvdControl2 instread.

 

Задает корневой каталог, содержащий том DVD-Video.

Синтаксис

HRESULT SetRoot(
  [in] LPCWSTR pszPath
);

Параметры

[in] pszPath

Указатель на имя каталога, задается в качестве корневого каталога.

Возвращаемое значение

Возвращает значение HRESULT .

Комментарии

Этот метод возвращает ошибку, если домен не DVD_DOMAIN_Stop. Дополнительные сведения см. в разделе DVD_DOMAIN.

Если вы не задали корневой каталог перед вызовом IDvdControl::TitlePlay, в качестве корневого будет использоваться первый диск, начиная с C: который содержит каталог VIDEO_TS в каталоге верхнего уровня.

Требования

Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)

См. также раздел

Коды ошибок и успешности

Интерфейс IDvdControl