IOverlayNotify::OnClipChange-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 OnClipChange -Methode stellt eine Benachrichtigung bereit, dass sich der sichtbare Bereich des Fensters geändert hat. Es ist wichtig, dass alle Überlagerungshardware aktualisiert wird, um die Änderung des sichtbaren Bereichs widerzuspiegeln, bevor sie von dieser Methode zurückgegeben wird.

Syntax

HRESULT OnClipChange(
  [in] const RECT    *pSourceRect,
  [in] const RECT    *pDestinationRect,
  [in] const RGNDATA *pRgnData
);

Parameter

[in] pSourceRect

Zeiger auf den Bereich des zu verwendenden Videos.

[in] pDestinationRect

Zeiger auf das Videoziel.

[in] pRgnData

Zeiger auf die Beschneidungsinformationen.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn die Methode fehlschlägt, wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Die Aufrufe erfolgen OnClipChange in Synchronisierung mit dem Fenster. Es wird mit einer leeren Clipliste aufgerufen, um das Video einzufrieren, bevor sich das Fenster bewegt, und dann wird erneut aufgerufen, wenn das Fenster mit der neuen Clipliste stabilisiert wurde.

Wenn das Fensterrechteck alle Nullen aufweist, ist das Fenster unsichtbar. Wie bei AVI-Decodern sollte der Decoder das Bild speichern, wenn das aktuelle Bild zum Decodieren des nächsten Bilds verwendet wird.

Anforderungen

   
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

Siehe auch

Fehler- und Erfolgscodes

IOverlayNotify-Schnittstelle