Export (0) Print
Expand All

CBaseAllocator.SetNotify method

[SetNotify may be altered or unavailable in subsequent versions.]

The SetNotify method sets or removes a callback on the allocator. The allocator calls the callback method whenever the allocator's IMemAllocator::ReleaseBuffer method is called.

Syntax


HRESULT SetNotify(
  IMemAllocatorNotifyCallbackTemp *pNotify
);

Parameters

pNotify

Pointer to the IMemAllocatorNotifyCallbackTemp interface that will be used for the callback. The caller must implement the interface. Use the value NULL to remove the callback.

Return value

Returns S_OK.

Remarks

This method implements the IMemAllocatorCallbackTemp::SetNotify method. The allocator does not expose the IMemAllocatorCallbackTemp interface unless the fEnableReleaseCallback flag is set to TRUE in the CBaseAllocator constructor.

This method sets the CBaseAllocator::m_pNotify member variable equal to pNotify and increments the reference count on the interface. If m_pNotify is non-NULL, the allocator's ReleaseBuffer method calls IMemAllocatorNotifyCallbackTemp::NotifyRelease. See the Remarks section in that method for information about implementing the callback.

Requirements

Header

Amfilter.h (include Streams.h)

Library

Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)

See also

CBaseAllocator Class

 

 

Community Additions

ADD
Show:
© 2014 Microsoft