CBaseInputPin::GetAllocator

Retrieves the allocator interface that this input pin identifies as the interface for the output pin to use.

HRESULT GetAllocator(
IMemAllocator **ppAllocator);

Parameters

• ppAllocator
  Pointer to an obtained IMemAllocator object.

Return Values

Default implementation returns either E_OUTOFMEMORY, if an allocator cannot be created, or NOERROR upon success.

Remarks

This member function implements the IMemInputPin::GetAllocator method, which is called by the connected output pin to retrieve an allocator to use for transporting media samples. By default, this member function creates a CMemAllocator object and obtains the IMemAllocator interface, to which it adds a reference count for the pin when assigning it to the m_pAllocator data member, and adds another reference count before passing it back to the output pin.

Override this member function if your filter has another allocator, such as one from a downstream pin, or a specialized allocator to offer the connected output pin.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.