IVMRSurfaceAllocator9::InitializeDevice

  • Article
 
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