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)

Siehe auch

Verwenden des Videomischrenderers