IMemInputPin::GetAllocatorRequirements method

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

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)
Library Strmiids.lib

See also

Error and Success Codes

IMemInputPin Interface