IVMRSurfaceAllocatorEx9::GetSurfaceEx

Microsoft DirectShow 9.0

This topic applies to Windows XP Service Pack 2 and later.

The GetSurfaceEx method retrieves a Direct3D surface and a destination rectangle.

Syntax

  HRESULT GetSurfaceEx(
  DWORD_PTR  dwUserID,
  DWORD  SurfaceIndex,
  DWORD  SurfaceFlags,
  IDirect3DSurface9**  lplpSurface,
  RECT* prcDst
);

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] Index of the surface to retrieve.

SurfaceFlags

[in] Surface flags.

lplpSurface

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

prcDst

[out] Location within the surface where the VMR-9 should write the composited image.

Return Values

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

Value	Description
S_OK	The method succeeded.

Requirements

Header: Include D3d9.h, Vmr9.h.

Library: Use Strmiids.lib.

See Also

Additional resources