Microsoft DirectX 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] Address of a variable that 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

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.

See Also