Microsoft DirectX 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]  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

Include D3d9.h, Vmr9.h.

See Also