IVMRSurface-Schnittstelle (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 IVMRSurface Schnittstelle wird auf den Medienbeispielen implementiert, die vom Video Mixing Renderer Filter 7 (VMR-7) verwendet werden. Filter können diese Schnittstelle verwenden, um auf die zugrunde liegende DirectDraw-Oberfläche zuzugreifen, auf der das Medienbeispiel basiert. Filter müssen die Oberfläche immer mit den methoden sperren und entsperren, die auf dieser Schnittstelle verfügbar sind. Filter dürfen niemals die Sperre oder Entsperrung direkt auf der DirectDraw-Oberflächenschnittstelle aufrufen, die von der GetSurface-Methode zurückgegeben wird. Anwendungen verwenden diese Schnittstelle nicht.
Vererbung
Die IVMRSurface-Schnittstelle erbt von der IUnknown-Schnittstelle . IVMRSurface verfügt auch über folgende Arten von Membern:
Methoden
Die IVMRSurface-Schnittstelle verfügt über diese Methoden.
| IVMRSurface::GetSurface Die GetSurface-Methode ruft die angefügte DirectDraw-Oberflächenschnittstelle ab. |
| IVMRSurface::IsSurfaceLocked Die IsSurfaceLocked-Methode gibt an, ob die DirectDraw-Oberfläche, die an dieses Medienbeispiel angefügt ist, gesperrt ist. |
| IVMRSurface::LockSurface Die LockSurface-Methode sperrt die angefügte DirectDraw-Oberfläche. |
| IVMRSurface::UnlockSurface Die UnlockSurface-Methode entsperrt die angefügte DirectDraw-Oberfläche. |
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) |