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 |
|---|---|
|
Erfolg. |
|
Ungültiges Argument. |
|
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 |