IVMRImagePresenter::P resentImage-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 PresentImage -Methode wird genau in dem Moment aufgerufen, in dem dieser Videoframe präsentiert werden soll.
Syntax
HRESULT PresentImage(
[in] DWORD_PTR dwUserID,
[in] VMRPRESENTATIONINFO *lpPresInfo
);
Parameter
[in] dwUserID
Eine anwendungsdefinierte DWORD_PTR, die diese instance der VMR in Szenarien eindeutig identifiziert, in denen mehrere Instanzen der VMR mit einem einzelnen instance eines Allocator-Presenters verwendet werden. Weitere Informationen finden Sie unter Hinweise.
[in] lpPresInfo
Gibt die VMRPRESENTATIONINFO-Struktur an.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
PresentImage kann aufgerufen werden, wenn sich der Filter in einem ausgeführten oder angehaltenen Zustand befindet. StartPresenting und StopPresenting können nur im Status "Wird ausgeführt" aufgerufen werden. Wenn das Diagramm daher angehalten wird, bevor es ausgeführt wird, PresentImage wird vor StartPresenting aufgerufen.
Anwendungen können benutzerdefinierte Mischeffekte erstellen, indem sie eine einzelne instance eines Allocator-Presenter mit mehreren Instanzen der VMR entweder in einem einzelnen Filterdiagramm oder in mehreren Filtergraphen verwenden. Wenn Sie den Zuweisungs-Presenter auf diese Weise verwenden, können Anwendungen Datenströme aus verschiedenen Filtergraphen mischen oder verschiedene Datenströme innerhalb desselben Filtergraphen mischen. Wenn Sie eine einzelne instance der VMR verwenden, legen Sie diesen Wert auf Null fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |