IOverlayNotify::OnPositionChange-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 OnPositionChange -Methode stellt eine Benachrichtigung bereit, dass sich die Position geändert hat.
Syntax
HRESULT OnPositionChange(
[in] const RECT *pSourceRect,
[in] const RECT *pDestinationRect
);
Parameter
[in] pSourceRect
Zeiger auf das Quellvideorechteck.
[in] pDestinationRect
Zeiger auf das Zielvideorechteck. Beachten Sie, dass dies nicht auf den sichtbaren Anzeigebereich zugeschnitten ist.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn die Methode fehlschlägt, wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Bei dieser Methode handelt es sich um einen Rückruf, der für Hardwareüberlagerungskarten bestimmt ist, die nicht den Aufwand für synchrone Clippingupdates benötigen und nur wissen möchten, wann sich die Quell- oder Zielvideopositionen ändern.
Im Gegensatz zur IOverlayNotify::OnClipChange-Methode wird diese Methode nicht in Synchronisierung mit sich ändernden Fenstern aufgerufen, sondern irgendwann, nachdem sich das Fenster geändert hat (im Wesentlichen rechtzeitig mit WM_SIZE empfangenen Nachrichten). Dies eignet sich daher für Überlagerungskarten, die ihre Daten nicht in den Framepuffer einlagern.
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 |