CBaseInputPin.GetAllocatorRequirements method

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The GetAllocatorRequirements method retrieves the allocator properties requested by the input pin.

Syntax

HRESULT GetAllocatorRequirements(
   ALLOCATOR_PROPERTIES *pProps
);

Parameters

pProps

Pointer to an ALLOCATOR_PROPERTIES structure, which is filled in with the requirements.

Return value

Returns E_NOTIMPL.

Remarks

When an output pin initializes a memory allocator, it can call this method to determine whether the input pin has any buffer requirements. For more information, see CBaseOutputPin::DecideAllocator.

Implementing this method is optional. If the filter has specific alignment or prefix requirements, override this method.

Requirements

Requirement Value
Header
Amfilter.h (include Streams.h)
Library
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)

See also

CBaseInputPin Class