CBaseInputPin::NotifyAllocator

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Notifies the input pin as to which allocator the output pin is actually going to use.

Syntax

HRESULT NotifyAllocator(
  IMemAllocator* pAllocator,
  BOOL bReadOnly
);

Parameters

• pAllocator
  Pointer to the IMemAllocator object to use.

  This might or might not be the same IMemAllocator object that the input pin provided in the IMemInputPin::GetAllocator method (the output pin could provide its own allocator).

• bReadOnly
  Flag to indicate if the samples from this allocator are read-only.

Return Value

Default implementation returns NOERROR.

Remarks

This member function implements the IMemInputPin::NotifyAllocator method, which is called by the connected output pin to inform the input pin of the chosen allocator for the memory transport.

Override this member function if your filter cares about this information.

By default, this sets the m_pAllocator data member to the allocator interface passed in after adding a reference count to that interface.

Requirements