CBaseAllocator.SetNotify-Methode

[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.]

[SetNotify kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die SetNotify -Methode legt einen Rückruf für die Zuweisung fest oder entfernt ihn. Die Zuweisung ruft die Rückrufmethode auf, wenn die IMemAllocator::ReleaseBuffer-Methode des Allocators aufgerufen wird.

Syntax

HRESULT SetNotify(
   IMemAllocatorNotifyCallbackTemp *pNotify
);

Parameter

pNotify

Zeiger auf die IMemAllocatorNotifyCallbackTemp-Schnittstelle , die für den Rückruf verwendet wird. Der Aufrufer muss die -Schnittstelle implementieren. Verwenden Sie den Wert NULL , um den Rückruf zu entfernen.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Diese Methode implementiert die IMemAllocatorCallbackTemp::SetNotify-Methode . Die Zuweisung macht die IMemAllocatorCallbackTemp-Schnittstelle nur verfügbar, wenn das fEnableReleaseCallback-Flag im CBaseAllocator-Konstruktor auf TRUE festgelegt ist.

Diese Methode legt die CBaseAllocator:: m_pNotify-Membervariable auf pNotify fest und erhöht die Verweisanzahl auf der Schnittstelle. Wenn m_pNotify nicht NULL ist, ruft die ReleaseBuffer-Methode des Allocators IMemAllocatorNotifyCallbackTemp::NotifyRelease auf. Informationen zur Implementierung des Rückrufs finden Sie im Abschnitt Hinweise in dieser Methode.

Anforderungen

Anforderung Wert
Header
Amfilter.h (streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseAllocator-Klasse