| 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.
Syntax
HRESULT GetAllocator(
IMemAllocator **ppAllocator
);
Parameters
ppAllocator
[out] Address of a variable that receives a pointer to the allocator's IMemAllocator interface.
Return Value
Returns an HRESULT value. Possible values include those shown in the following table.
| Value | Description |
| S_OK | Success. |
| VFW_E_NO_ALLOCATOR | No allocator is available. |
Remarks
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.
See Also