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

Weitere Informationen

Fehler- und Erfolgscodes

IOverlayNotify-Schnittstelle