IVMRSurfaceAllocator9::InitializeDevice
Microsoft DirectShow 9.0 |
IVMRSurfaceAllocator9::InitializeDevice
The InitializeDevice method is called by the Video Mixing Renderer 9 (VMR-9) when it needs the allocator-presenter to allocate surfaces.
Syntax
HRESULT InitializeDevice( DWORD_PTR dwUserID, VMR9AllocationInfo* lpAllocInfo, DWORD* lpNumBuffers );
Parameters
dwUserID
[in] Application-defined identifier. This value is the same value that the application passed to the IVMRSurfaceAllocatorNotify9::AdviseSurfaceAllocator method in the dwUserID parameter.
lpAllocInfo
[in] Pointer to a VMR9AllocationInfo structure that contains a description of the surfaces to create.
lpNumBuffers
[in, out] On input, specifies the number of surfaces to create. When the method returns, this parameter contains the number of buffers that were actually allocated.
Return Values
The method returns an HRESULT. Possible values include those in the following table.
Value | Description |
S_OK | The method succeeded. |
Remarks
Implement this method if you are providing a custom allocator-presenter for the VMR-9. You can use the IVMRSurfaceAllocatorNotify9::AllocateSurfaceHelper method on the VMR-9 to allocate the surfaces.
Requirements
Header: Include D3d9.h, Vmr9.h.
Library: Use Strmiids.lib.
See Also