CTransInPlaceOutputPin::ReceiveAllocator (Windows CE 5.0)

Send Feedback

Receives notification of which allocator will be used.

HRESULT ReceiveAllocator(IMemAllocator* pAllocator,BOOLbReadOnly);

Parameters

  • pAllocator
    Pointer to the IMemAllocator object to use.
  • bReadOnly
    Flag to indicate if the samples from this allocator are read-only.

Return Values

Returns NOERROR if the allocator has the correct properties and is not read-only. Returns S_OK if successful if the allocator has the correct properties but is read-only; otherwise, returns VFW_E_BADALIGN, VFW_E_ALREADY_COMMITTED, VFW_E_BUFFERS_OUTSTANDING, or E_FAIL if the allocator's properties do not match what is needed.

Remarks

This member function is called by the CTransInPlaceInputPin::NotifyAllocator member function to indicate to the output pin which allocator will be used.

It is only called if the output pin is connected.

The choice is propagated to input pins downstream if the allocator is not read-only.

For read-only allocators, only the properties are passed downstream.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.