Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 IMemAllocatorobject to use.

This might or might not be the same IMemAllocatorobject that the input pin provided in the IMemInputPin::GetAllocatormethod (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::NotifyAllocatormethod, 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_pAllocatordata member to the allocator interface passed in after adding a reference count to that interface.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment,
Version 2.12 requires DXPAK 1.0 or later