IMemInputPin::GetAllocatorRequirements

  • Article
 
Microsoft DirectShow 9.0

IMemInputPin::GetAllocatorRequirements

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

Syntax

  HRESULT GetAllocatorRequirements(
  ALLOCATOR_PROPERTIES *pProps
);

Parameters

pProps

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

Return Values

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

Return code Description
S_OK Success
E_NOTIMPL Not implemented
E_POINTER NULL pointer argument

Remarks

When an output pin initializes a memory allocator, it can call this method to determine whether the input pin has any buffer requirements. The input pin is not required to implement this method. If the filter has specific alignment or prefix requirements, it should implement this method.

Requirements

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

Library: Use Strmiids.lib.

See Also