IDvdState-Schnittstelle (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die IDvdState-Schnittstelle speichert den aktuellen Zustand zwischen.
Das Objekt, das diese Schnittstelle implementiert, wird als DVD-Lesezeichen bezeichnet. Sie können ihn verwenden, um den DVD-Zustand zu speichern und wiederherzustellen, der den Wiedergabespeicherort, die Elterebene des Benutzers und die DVD-Region umfasst.
Vererbung
Die IDvdState-Schnittstelle erbt von der IUnknown-Schnittstelle . IDvdState verfügt auch über die folgenden Typen von Membern:
Methoden
Die IDvdState-Schnittstelle verfügt über diese Methoden.
| IDvdState::GetDiscID Die GetDiscID-Methode ruft die eindeutige ID des Datenträgers ab, von dem das Lesezeichen erstellt wurde. |
| IDvdState::GetParentalLevel Die GetParentalLevel-Methode ruft die Elterebene des Benutzers ab, wie sie im DvdState-Objekt gespeichert ist. |
Hinweise
Rufen Sie IDvdInfo2::GetState auf, um die aktuellen DVD-Statusinformationen aus dem DVD-Navigator abzurufen. Um den Zustand wiederherzustellen, rufen Sie IDvdControl2::SetState auf.
Das DVD-Lesezeichenobjekt implementiert auch IPersistStream und IPersistMemory. Sie können diese Schnittstellen verwenden, um den Zustand beizubehalten. Sie können auch ein leeres Lesezeichenobjekt erstellen, indem Sie CoCreateInstance aufrufen. Die CLSID des Objekts ist CLSID_DVDState, definiert in uuids.h.
Vor Windows Vista kann ein Lesezeichen nur auf dem Computer verwendet werden, auf dem es erstellt wurde. Ab Windows Vista kann der DVD-Navigator Lesezeichen erstellen, die von anderen Computern verwendet werden können. Um dieses Feature zu aktivieren, rufen Sie IDvdControl2::SetOption mit dem flag DVD_EnablePortableBookmarks auf, bevor Sie GetState oder SetState aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |