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 |