IVMRSurfaceAllocator::P repareSurface-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 PrepareSurface Methode bereitet die DirectDraw-Oberfläche so vor, dass der nächste Videoframe darin decodiert wird.
Syntax
HRESULT PrepareSurface(
[in] DWORD_PTR dwUserID,
[in] LPDIRECTDRAWSURFACE7 lpSurface,
[in] DWORD dwSurfaceFlags
);
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.
[in] lpSurface
Gibt die DirectDraw-Oberfläche an.
[in] dwSurfaceFlags
Doppeltes Wort, das die Oberflächenflags enthält. Siehe Hinweise.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
Das einzige Flag, das der VMR hier derzeit überprüft, ist AM_GBF_NOTASYNCPOINT (0x00000002), das angibt, dass Sie diesen Puffer nicht mit einem Synchronisierungspunkt (Keyframe) füllen werden.
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 |