IVMRImagePresenter::StartPresenting-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die StartPresenting -Methode wird aufgerufen, bevor das Video abgespielt wird. Der Zuteilungs-Referenten sollte alle erforderlichen Konfigurationen in dieser Methode ausführen.
Syntax
HRESULT StartPresenting(
[in] DWORD_PTR dwUserID
);
Parameter
[in] dwUserID
Ein anwendungsdefiniertes DWORD_PTR Cookie, das diese instance der VMR für die Verwendung in Szenarien eindeutig identifiziert, in denen eine instance des Zuteilungs-Referenten mit mehreren VMR-Instanzen verwendet wird.
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 kann nur im Ausführungszustand aufgerufen werden. Wenn das Diagramm daher angehalten wird, bevor es ausgeführt wird, wird PresentImage vor StartPresentingaufgerufen.
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 |
Weitere Informationen
IVMRImagePresenter-Schnittstelle