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

Receives notification of which allocator will be used by the connected output pin.

Syntax

HRESULT NotifyAllocator(
  IMemAllocator* 
pAllocator,
  BOOL 
bReadOnly 
);

Parameters

pAllocator

Pointer to the IMemAllocatorobject to use.

This might or might not be the same CTransInPlaceInputPinobject that the input pin provided in the CTransInPlaceInputPin::GetAllocatormember function (the output pin could provide its own allocator).

bReadOnly

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

Return Value

Returns NOERROR if successful.

Returns E_POINTER if the pointer is invalid.

Otherwise, returns an error due to calling CTransInPlaceOutputPin::ReceiveAllocator.

Remarks

This member function overrides the CBaseInputPin::NotifyAllocatormember function and implements the IMemInputPin::NotifyAllocatormethod.

This member function remembers the allocator and passes it to the output pin because they both must share the same allocator.

Requirements

Windows Embedded CE Windows CE 2.12 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