IVMRSurfaceAllocator::AdviseNotify-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 AdviseNotify -Methode stellt dem Zuweisungs-Referenten die Schnittstelle des VMR-7-Filters für Benachrichtigungsrückrufe zur Verfügung. Wenn Sie einen benutzerdefinierten Zuteilungs-Presenter verwenden, muss die Anwendung diese Methode für den Allocator-Presenter mit einem Zeiger auf die IVMRSurfaceAllocatorNotify-Schnittstelle der VMR aufrufen. Der Zuteilungs-Referenten verwendet diese Schnittstelle, um mit dem VMR zu kommunizieren.

Wenn Sie keinen benutzerdefinierten Zuweisungs-Presenter verwenden, muss die Anwendung diese Methode nicht aufrufen.

Syntax

HRESULT AdviseNotify(
  [in] IVMRSurfaceAllocatorNotify *lpIVMRSurfAllocNotify
);

Parameter

[in] lpIVMRSurfAllocNotify

Gibt den IVMRSurfaceAllocatorNotify-Schnittstellenzeiger an, den der Zuweisungs-Referenten verwendet, um Benachrichtigungen zurück an den VMR zu übergeben.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

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

Fehler- und Erfolgscodes

IVMRSurfaceAllocator-Schnittstelle

Bereitstellen eines benutzerdefinierten Allocator-Presenter für VMR-7

Verwenden des Videomischrenderers

RENDERLOSER VMR-Wiedergabemodus (Benutzerdefinierte Zuteilungs-Referenten)