IVMRSurfaceAllocator::PrepareSurface

 
Microsoft DirectShow 9.0

IVMRSurfaceAllocator::PrepareSurface

The PrepareSurface method prepares the DirectDraw surface to have the next video frame decoded into it.

Syntax

  HRESULT PrepareSurface(
  DWORD_PTR  dwUserID,
  LPDIRECTDRAWSURFACE7  lpSurface,
  DWORD  dwSurfaceFlags
);

Parameters

dwUserID

[in]  An application-defined DWORD_PTR cookie that uniquely identifies this instance of the VMR for use in scenarios when one instance of the allocator-presenter is used with multiple VMR instances.

lpSurface

[in]  Specifies the DirectDraw surface

dwSurfaceFlags

[in]  Double word containing the surface flags. See Remarks.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

The only flag that the VMR currently checks here is AM_GBF_NOTASYNCPOINT (0x00000002), which indicates that you are not going to fill this buffer with a sync point (keyframe).

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also