Méthode CBaseAllocator.SetNotify

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

[SetNotify peut être modifié ou indisponible dans les versions suivantes.]

La SetNotify méthode définit ou supprime un rappel sur l’allocateur. L’allocateur appelle la méthode de rappel chaque fois que la méthode IMemAllocator::ReleaseBuffer de l’allocateur est appelée.

Syntaxe

HRESULT SetNotify(
   IMemAllocatorNotifyCallbackTemp *pNotify
);

Paramètres

pNotify

Pointeur vers l’interface IMemAllocatorNotifyCallbackTemp qui sera utilisée pour le rappel. L’appelant doit implémenter l’interface. Utilisez la valeur NULL pour supprimer le rappel.

Valeur renvoyée

Retourne S_OK.

Notes

Cette méthode implémente la méthode IMemAllocatorCallbackTemp::SetNotify . L’allocateur n’expose pas l’interface IMemAllocatorCallbackTemp , sauf si l’indicateur fEnableReleaseCallback a la valeur TRUE dans le constructeur CBaseAllocator .

Cette méthode définit la variable membre CBaseAllocator::m_pNotify égale à pNotify et incrémente le nombre de références sur l’interface. Si m_pNotify n’est pas NULL, la méthode ReleaseBuffer de l’allocateur appelle IMemAllocatorNotifyCallbackTemp::NotifyRelease. Pour plus d’informations sur l’implémentation du rappel, consultez la section Remarques de cette méthode.

Configuration requise

Condition requise	Valeur
En-tête	Amfilter.h (include Streams.h)
Bibliothèque	Strmbase.lib (builds de vente au détail) ; Strmbasd.lib (builds de débogage)

Voir aussi

CBaseAllocator, classe