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

Weitere Informationen

Fehler- und Erfolgscodes

IVMRImagePresenter-Schnittstelle

Verwenden des Videomischrenderers