IDvdInfo2::GetCurrentUOPS-Methode (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 GetCurrentUOPS -Methode ruft eine Reihe von Flags ab, die angeben, welche Navigationsbefehle die Inhaltsautoren für den aktuellen Datenträgerspeicherort explizit deaktiviert haben.

Syntax

HRESULT GetCurrentUOPS(
  [out] ULONG *pulUOPs
);

Parameter

[out] pulUOPs

Empfängt bitweise VALID_UOP_FLAG Werte. Jedes Bit stellt den Status (gültig oder ungültig) eines Benutzervorgangs (UOP) dar. Wenn das Bit festgelegt ist, ist dieser Benutzervorgang verboten. Siehe Hinweise.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	pulUOPs ist kein gültiger Zeiger.

Hinweise

DVD-Autoren können UOP-Befehle an fast jeder Beliebigen Stelle auf dem Datenträger einfügen, um einen Navigationsbefehl zu verweigern, der andernfalls innerhalb der aktuellen DVD-Domäne zulässig wäre. Mit anderen Worten: Mit UOP-Befehlen können Discautoren die üblichen Navigationsberechtigungen außer Kraft setzen.

Eine DVD-Playeranwendung sollte diese Methode normalerweise nie verwenden müssen, da der DVD-Navigator automatisch alle UOP-Berechtigungen überprüft, bevor er mit einem Beliebigen Befehl fortschreitet, und gibt VFW_E_DVD_OPERATION_INHIBITED von einer beliebigen Methode zurück, wenn der Befehl unter der aktuellen UOP ungültig ist. Wenn Ihre Anwendung die aktuellen UOP-Berechtigungen selbst nachverfolgen muss, können Sie immer dann aufrufen GetCurrentUOPS , wenn die aktuellen UOP-Berechtigungen erforderlich sind, oder Sie können die EC_DVD_VALID_UOPS_CHANGE Ereignisbenachrichtigung in Ihrer Nachrichtenschleife verarbeiten und die UOP-Informationen aus dem lParam1-Parameter abrufen. Letzteres ist in der Regel effizienter.

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

Weitere Informationen

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdInfo2-Schnittstelle