CTransInPlaceInputPin::GetAllocator

  • Article
 
Microsoft DirectShow 9.0

CTransInPlaceInputPin::GetAllocator

The GetAllocator method retrieves the memory allocator proposed by this pin. This method implements the IMemInputPin::GetAllocator method.

Syntax

  HRESULT GetAllocator(
    IMemAllocator **ppAllocator
);

Parameters

ppAllocator

Receives a pointer to the allocator's IMemAllocator interface.

Return Value

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

Value Description
S_OK Success.
VFW_E_NO_ALLOCATOR No allocator is available.

Remarks

If the filter's output pin is connected, this method requests an allocator from the downstream filter's input pin.

If the filter's output pin is not connected, this method creates a temporary allocator. Later, when the output pin is connected, the filter will reconnect the input pin and renegotiate the allocator.

Requirements

**  Header:** Declared in Transip.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also