IAMOverlayFX::GetOverlayFX-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 GetOverlayFX -Methode ruft die Effekte ab, die derzeit auf die Überlagerungsoberfläche angewendet werden, sofern vorhanden. Die Anwendung kann diese Methode aufrufen, während das Filterdiagramm ausgeführt wird.

Syntax

HRESULT GetOverlayFX(
  [out] DWORD *lpdwOverlayFX
);

Parameter

[out] lpdwOverlayFX

Zeiger einer Variablen, die einen Wert empfängt, der angibt, welche Effekte( falls vorhanden) derzeit auf die Überlagerungsoberfläche angewendet werden. Der Wert ist eine logische Kombination von Flags aus der AMOVERLAYFX-Enumeration .

Rückgabewert

Gibt einen HRESULT-Wert zurück, der von der Implementierung der Schnittstelle abhängt. Die DirectShow-Implementierung gibt bei erfolgreicher Ausführung S_OK oder E_POINTER zurück, um ein NULL-Zeigerargument anzugeben.

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

Fehler- und Erfolgscodes

IAMOverlayFX-Schnittstelle