Share via


IMemInputPin::GetAllocator

 
Microsoft DirectShow 9.0

IMemInputPin::GetAllocator

The GetAllocator method retrieves the memory allocator proposed by this pin. After the allocator has been selected, this method returns a pointer to the selected allocator.

Syntax

  HRESULT GetAllocator(
  IMemAllocator **ppAllocator
);

Parameters

ppAllocator

[out] Receives a pointer to the allocator's IMemAllocator interface. The caller must release the interface.

Return Values

Returns an HRESULT value. Possible values include those shown in the following table.

Return code Description
S_OK Success.
VFW_E_NO_ALLOCATOR No allocator is available.

Remarks

When an output pin connects to an input pin, it negotiates with the input pin to decide on a memory allocator. The output pin calls this method to retrieve the input pin's proposed allocator. It calls the IMemInputPin::NotifyAllocator method to specify which allocator it selected.

If this method succeeds, the IMemAllocator interface has an outstanding reference count. Be sure to release it when you are done.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also