Windows Dev Center

IVMRSurfaceAllocatorNotify9::AdviseSurfaceAllocator method

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

Syntax


HRESULT AdviseSurfaceAllocator(
  [in] DWORD_PTR             dwUserID,
  [in] 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 value

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

Return codeDescription
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.

Include DShow.h and D3d9.h before Vmr9.h.

Requirements

Minimum supported client

Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Vmr9.h

Library

Strmiids.lib

See also

Using the Video Mixing Renderer
IVMRSurfaceAllocatorNotify9 Interface

 

 

Community Additions

ADD
Show:
© 2015 Microsoft