IMemAllocatorCallbackTemp::SetNotify-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 SetNotify -Methode legt einen Rückruf für den Zuteilungsgeber fest oder entfernt ihn. Der Allocator 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 bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlercode zurück.
Hinweise
Wenn die ReleaseBuffer-Methode des Allocators aufgerufen wird, ruft der Allocator die NotifyRelease-Methode auf der in pNotify bereitgestellten Schnittstelle auf. Die ReleaseBuffer-Methode gibt ein Medienbeispiel in die kostenlose Liste des Zuteilungsgebers zurück. Beispiele rufen diese Methode auf, wenn ihre Verweisanzahl 0 erreicht.
Die Zuordnung enthält eine Verweisanzahl auf der IMemAllocatorNotifyCallbackTemp-Schnittstelle des Aufrufers. Dadurch können kreisförmige Verweisanzahlen erstellt werden, wodurch verhindert wird, dass Objekte im Diagramm ordnungsgemäß freigegeben werden. Wenn der Aufrufer daher keine Rückrufbenachrichtigungen mehr benötigt, sollte er diese Methode erneut mit dem Wert NULL aufrufen. Ein geeigneter Zeitpunkt hierfür ist, wenn das Diagramm beendet wird, oder wenn die Pins getrennt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |