CTransInPlaceInputPin.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 pin. This method implements the IMemInputPin::GetAllocatorRequirements method.
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 |
|---|---|
|
Success |
|
The output pin is not connected, or the downstream input pin does not support the method. |
|
NULL pointer argument |
Remarks
If the output pin is connected, this method passes the call to the downstream input pin. Otherwise, it returns E_NOTIMPL.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|