IVMRSurfaceAllocatorNotify-Schnittstelle (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 IVMRSurfaceAllocatorNotify Schnittstelle wird vom Video Mixing Renderer Filter 7 (VMR-7) implementiert. Anwendungen verwenden diese Schnittstelle, um einen benutzerdefinierten Zuweisungs-Presenter festzulegen, und der Zuteilungs-Referenten verwendet diese Schnittstelle, um die VMR-7 über Änderungen an der Systemumgebung zu informieren, die sich auf die DirectDraw-Oberflächen auswirken.
Damit eine Anwendung diese Schnittstelle abrufen kann, muss sich die VMR im renderlosen Modus befinden.
Verwenden Sie für VMR-9 die IVMRSurfaceAllocatorNotify9-Schnittstelle .
Vererbung
Die IVMRSurfaceAllocatorNotify-Schnittstelle erbt von der IUnknown-Schnittstelle . IVMRSurfaceAllocatorNotify verfügt auch über folgende Membertypen:
Methoden
Die IVMRSurfaceAllocatorNotify-Schnittstelle verfügt über diese Methoden.
| IVMRSurfaceAllocatorNotify::AdviseSurfaceAllocator Die AdviseSurfaceAllocator-Methode wird von einer Anwendung aufgerufen, um den VMR anzuweisen, einen benutzerdefinierten Zuteilungs-Presenter zu verwenden. |
| IVMRSurfaceAllocatorNotify::ChangeDDrawDevice Die ChangeDDrawDevice-Methode benachrichtigt den VMR, dass das DirectDraw-Wiedergabegerät geändert wurde. In einem System mit mehreren Monitoren hat der Benutzer beispielsweise das Videorechteck von einem Monitor auf einen anderen verschoben. |
| IVMRSurfaceAllocatorNotify::NotifyEvent Die NotifyEvent-Methode wird vom Allocator-Presenter aufgerufen, um den VMR über alle wichtigen DirectShow-Ereignisse während des Zuordnungs- oder Präsentationsprozesses zu informieren. |
| IVMRSurfaceAllocatorNotify::RestoreDDrawSurfaces Die RestoreDDrawSurfaces-Methode benachrichtigt den VMR, dass ein DirectDraw-Oberflächenverlust erkannt wurde. |
| IVMRSurfaceAllocatorNotify::SetBorderColor Die SetBorderColor-Methode gibt für die VMR an, welche Farbe in Bereichen des Anzeigerechtecks verwendet werden soll, die nicht für Video verwendet werden, z. B. wenn das Video im Briefkasten steht. |
| IVMRSurfaceAllocatorNotify::SetDDrawDevice Die SetDDrawDevice-Methode legt das anfängliche DirectDraw-Gerät und den Monitor für die Videowiedergabe fest. |
Anforderungen
| 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) |