IDDrawExclModeVideoCallback::OnUpdateOverlay-Methode (strmif.h)

Artikel
03/02/2024

[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 OnUpdateOverlay -Methode informiert die Anwendung, wenn die Überlagerungsfläche für das Video sichtbar, unsichtbar, größe oder Position geändert wird, sodass die Anwendung ihr Fenster entsprechend neu streichen kann.

Syntax

HRESULT OnUpdateOverlay(
  [in] BOOL       bBefore,
  [in] DWORD      dwFlags,
  [in] BOOL       bOldVisible,
  [in] const RECT *prcOldSrc,
  [in] const RECT *prcOldDest,
  [in] BOOL       bNewVisible,
  [in] const RECT *prcNewSrc,
  [in] const RECT *prcNewDest
);

Parameter

[in] bBefore

Boolescher Wert, der angibt, ob der Aufruf vor oder nach der Überlagerungsänderung erfolgt. TRUE gibt vor an, FALSE gibt nach an.

[in] dwFlags

Wert aus der AM_OVERLAY_NOTIFY_FLAGS-Enumeration , die angibt, was oder was geändert werden soll.

[in] bOldVisible

Boolescher Wert, der angibt, ob das alte Fenster sichtbar ist. TRUE bedeutet, dass das alte Fenster sichtbar ist.

[in] prcOldSrc

Zeiger auf das Rechteck, das die alte Quellposition der DirectDraw-Oberfläche darstellt.

[in] prcOldDest

Zeiger auf das Rechteck, das die alte Zielposition des Rechtecks in der Überlagerungsoberfläche darstellt.

[in] bNewVisible

Boolescher Wert, der angibt, ob das neue Fenster sichtbar ist. TRUE bedeutet, dass das neue Fenster sichtbar ist.

[in] prcNewSrc

Zeiger auf das Rechteck, das die neue Quellposition der DirectDraw-Oberfläche darstellt.

[in] prcNewDest

Zeiger auf das Rechteck, das die neue Zielposition des Rechtecks in der Überlagerungsoberfläche darstellt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Ungültiger Parameter.

Hinweise

Die Anwendung sollte diese Methode einmal aufrufen, bevor die Änderung im Zusammenhang mit der Überlagerung erfolgt, und einmal, nachdem die Änderungen vorgenommen wurden. Im Aufruf vor der Änderung erfolgt die Überlagerungsänderung erst, wenn die Anwendung die Ausführung dieser Methode abgeschlossen hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IDDrawExclModeVideoCallback-Schnittstelle

Freigeben über