|Microsoft DirectX 9.0|
The GetAllocator method retrieves the memory allocator proposed by this pin. After the allocator has been selected, this method returns a pointer to the selected allocator.
HRESULT GetAllocator( IMemAllocator **ppAllocator );
[out] Address of a variable that receives a pointer to the allocator's IMemAllocator interface.
Returns an HRESULT value. Possible values include those shown in the following table.
|VFW_E_NO_ALLOCATOR||No allocator is available.|
When an output pin connects to an input pin, it negotiates with the input pin to decide on a memory allocator. The output pin calls this method to retrieve the input pin's proposed allocator. It calls the IMemInputPin::NotifyAllocator method to specify which allocator it selected.
If this method succeeds, the IMemAllocator interface has an outstanding reference count. Be sure to release it when you are done.