 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Receives notification of which allocator will be used.
HRESULT ReceiveAllocator( IMemAllocator * pAllocator, BOOL bReadOnly );
Parameters
- pAllocator
- Pointer to the IMemAllocatorobject to use.
- bReadOnly
- Flag to indicate if the samples from this allocator are
read-only.
Return Values
Returns NOERROR if the allocator has the correct properties and is not read-only. Returns S_OK if successful if the allocator has the correct properties but is read-only; otherwise, returns VFW_E_BADALIGN, VFW_E_ALREADY_COMMITTED, VFW_E_BUFFERS_OUTSTANDING, or E_FAIL if the allocator's properties don't match what is needed.
Remarks
This member function is called by the CTransInPlaceInputPin::NotifyAllocatormember function to indicate to the output pin which allocator will be used. It is only called if the output pin is connected. The choice is propagated to input pins downstream if the allocator is not read-only. For read-only allocators, only the properties are passed downstream.