IDvdInfo2::GetState-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die GetState -Methode ruft ein Lesezeichen ab, das den Datenträgerspeicherort und informationen zum DVD-Navigator-Status enthält.

Syntax

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

Parameter

[out] pStateData

Empfängt einen Zeiger auf die IDvdState-Schnittstelle eines vom DVD-Navigator zugeordneten DvdState-Objekts .

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	Beschreibung
S_OK	Erfolg.
E_INVALIDARG	Ungültiges Argument.
E_UNEXPECTED	DER DVD-Navigator wird nicht initialisiert.

Bemerkungen

Wenn diese Methode aufgerufen wird, erstellt der DVD-Navigator ein neues Zustandsobjekt und speichert darin den aktuellen Speicherort sowie die aktuelle Elternebene und andere Statusinformationen. Das DVDState-Objekt kann verwendet werden, um den DVD-Navigator zu einem späteren Zeitpunkt über einen Aufruf von IDvdControl2::SetState am gespeicherten Speicherort wiederherzustellen. Auf diese Weise können Die Betrachter die Anzeige in der Mitte eines Datenträgers beenden, den Speicherort speichern und zu einem späteren Zeitpunkt zurückkehren, um zu beginnen, an der Stelle anzuzeigen, an der sie aufgehört haben, wobei alle internen Einstellungen wie zuvor wiederhergestellt wurden.

Der DVD-Navigator ruft AddRef für das DvdState-Objekt auf, bevor es an die Anwendung zurückgegeben wird. Die Anwendung muss Release für das -Objekt aufrufen, wenn es damit fertig ist.

Diese Methode wird in der DVDSample-Anwendung in CDvdCore::RestoreBookmark veranschaulicht.

Anforderungen

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)
Bibliothek	Strmiids.lib

Siehe auch

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdInfo2-Schnittstelle