Export (0) Print
Expand All

IMemInputPin::GetAllocator method

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(
  [out]  IMemAllocator **ppAllocator
);

Parameters

ppAllocator [out]

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

Return value

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

Return codeDescription
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Error and Success Codes
IMemInputPin Interface

 

 

Community Additions

ADD
Show:
© 2015 Microsoft