IVMRSurfaceAllocatorNotify9::AdviseSurfaceAllocator

  • Article
 
Microsoft DirectShow 9.0

IVMRSurfaceAllocatorNotify9::AdviseSurfaceAllocator

The AdviseSurfaceAllocator method is called by an application to instruct the VMR-9 to use a custom allocator-presenter.

Syntax

  HRESULT AdviseSurfaceAllocator(
  DWORD_PTR  dwUserID,
  IVMRSurfaceAllocator9*  lpIVRMSurfaceAllocator
);

Parameters

dwUserID

[in]  Application-defined value that identifies this instance of the VMR-9.

lpIVRMSurfaceAllocator

[in]  Pointer to the IVMRSurfaceAllocator9 interface on the custom surface allocator object.

Return Values

The method returns an HRESULT. Possible values include those in the following table.

Value Description
S_OK The method succeeded.

Remarks

This method can be called only once in the lifetime of the VMR. The VMR continues to use the allocator-presenter until the VMR is itself deleted. When the VMR is finally released, it releases its reference count on the custom allocator-presenter object, which allows that object to be freed.

The custom allocator-presenter must also support the IVMRImagePresenter9 interface.

Requirements

Header: Include D3d9.h, Vmr9.h.

Library: Use Strmiids.lib.

See Also