GetSurface
Collapse the table of content
Expand the table of content

IVMRSurfaceAllocator9::GetSurface method

The GetSurface method gets a Direct3D surface from the allocator-presenter.

Syntax


HRESULT GetSurface(
  [in]  DWORD_PTR         dwUserID,
  [in]  DWORD             SurfaceIndex,
  [in]  DWORD             SurfaceFlags,
  [out] IDirect3DSurface9 **lplpSurface
);

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.

SurfaceIndex [in]

Specifies the index of the surface to retrieve.

SurfaceFlags [in]

Reserved.

lplpSurface [out]

Receives a pointer to the IDirect3DSurface9 interface. The caller must release the interface.

Return value

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

Return codeDescription
S_OK

The method succeeded.

 

Remarks

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

Error and Success Codes
IVMRSurfaceAllocator9 Interface
Supplying a Custom Allocator-Presenter for VMR-9
Using the Video Mixing Renderer

 

 

Show:
© 2016 Microsoft