共用方式為

IVMRSurfaceAllocatorEx9::GetSurfaceEx

  • 發行項
 
Microsoft DirectShow 9.0

IVMRSurfaceAllocatorEx9::GetSurfaceEx

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