Поделиться через


Метод IDvdInfo::GetRoot (strmif.h)

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

Примечание Интерфейс IDvdInfo является устаревшим. Вместо этого используйте IDvdInfo2 .
 
Извлекает корневой каталог, заданный в проигрывателе.

Синтаксис

HRESULT GetRoot(
  [out] LPSTR pRoot,
  [in]  ULONG ulBufSize,
  [out] ULONG *pulActualSize
);

Параметры

[out] pRoot

Указатель на буфер для получения корневой строки. Обратите внимание, что в корневой строке используются символы ANSI.

[in] ulBufSize

Размер переданного буфера в байтах.

[out] pulActualSize

Указатель на значение, содержащее размер фактически возвращаемых данных.

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

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

Код возврата Описание
E_UNEXPECTED
DVD-диск не инициализирован или домен не DVD_DOMAIN_Title.
S_OK
Успешно.
VFW_E_DVD_INVALIDDOMAIN
Запрошенное действие не поддерживается в этом домене (DVD_DOMAIN).
VFW_E_DVD_OPERATION_INHIBITED
Запрошенное действие не может произойти в данный момент в фильме из-за создания текущего диска DVD-Video.

Комментарии

Если найден допустимый корень, этот метод возвращает корневую строку. В противном случае возвращается ноль для pcbActualSize, что означает, что допустимый корневой каталог не найден или не инициализирован.

Требования

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

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

Коды ошибок и успешного выполнения

Интерфейс IDvdInfo