Microsoft DirectX 8.1 (C++)

IVMRSurfaceAllocator::PrepareSurface

This topic applies to Windows XP Home Edition and Windows XP Professional only.

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).

See Also