Интерфейс IDvdState (strmif.h)

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

Интерфейс IDvdState кэширует текущее состояние.

Объект, реализующий этот интерфейс, называется закладкой DVD. Его можно использовать для сохранения и восстановления состояния DVD, которое включает расположение воспроизведения, родительский уровень пользователя и регион DVD.

Наследование

Интерфейс IDvdState наследуется от интерфейса IUnknown . IDvdState также имеет следующие типы членов:

Методы

Интерфейс IDvdState содержит следующие методы.

 
IDvdState::GetDiscID

Метод GetDiscID извлекает уникальный идентификатор диска, с которого была создана закладка.
IDvdState::GetParentalLevel

Метод GetParentalLevel извлекает родительский уровень пользователя, сохраненный в объекте DvdState.

Комментарии

Чтобы получить сведения о текущем состоянии DVD из DVD-навигатора, вызовите IDvdInfo2::GetState. Чтобы восстановить состояние, вызовите IDvdControl2::SetState.

Объект закладки DVD также реализует IPersistStream и IPersistMemory. Эти интерфейсы можно использовать для сохранения состояния. Вы также можете создать пустой объект закладки, вызвав CoCreateInstance. ИДЕНТИФИКАТОР CLSID объекта CLSID_DVDState, определенный в uuids.h.

До windows Vista закладку можно было использовать только на том же компьютере, где она была создана. Начиная с Windows Vista, DVD-навигатор может создавать закладки, которые можно использовать на других компьютерах. Чтобы включить эту функцию, вызовите IDvdControl2::SetOption с флагом DVD_EnablePortableBookmarks перед вызовом GetState или SetState.

Требования

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

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

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