Метод IDvdInfo2::GetState (strmif.h)

Статья
07/28/2023

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

Метод GetState извлекает закладку, содержащую сведения о расположении диска и состоянии DVD-навигатора.

Синтаксис

HRESULT GetState(
  [out] IDvdState **pStateData
);

Параметры

[out] pStateData

Получает указатель на интерфейс IDvdState объекта DvdState , выделенного DVD-навигатором.

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

Возвращает одно из следующих значений HRESULT .

Код возврата	Описание
S_OK	Успешно.
E_INVALIDARG	Недопустимый аргумент.
E_UNEXPECTED	DVD-навигатор не инициализирован.

При вызове этого метода DVD Navigator создает новый объект состояния и сохраняет в нем текущее расположение, а также текущий родительский уровень и другие сведения о состоянии. Объект DVDState можно использовать для восстановления DVD-навигатора в сохраненном расположении позже с помощью вызова IDvdControl2::SetState. Это позволяет зрителям прекратить просмотр в середине диска, сохранить расположение и вернуться позже, чтобы начать просмотр с того места, где они остановились, со всеми внутренними параметрами, восстановленными, как и раньше.

DVD-навигатор вызывает AddRef для объекта DvdState , прежде чем возвращать его приложению. Приложение должно вызвать Release для объекта по завершении работы с ним.

Этот метод демонстрируется в приложении DVDSample в CDvdCore::RestoreBookmark.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)
Библиотека	Strmiids.lib

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

Dvd-приложения

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

Интерфейс IDvdInfo2