IDCompositionDevice::CreateSurfaceFromHandle method (dcomp.h)

Creates a new composition surface object that wraps an existing composition surface.

Syntax

HRESULT CreateSurfaceFromHandle(
  [in]  HANDLE   handle,
  [out] IUnknown **surface
);

Parameters

[in] handle

Type: HANDLE

The handle of an existing composition surface that was created by a call to the DCompositionCreateSurfaceHandle function.

[out] surface

Type: IUnknown**

The new composition surface object. This parameter must not be NULL.

Return value

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See DirectComposition Error Codes for a list of error codes.

Remarks

This method enables an application to use a shared composition surface in a composition tree.

Requirements

See also

IDCompositionDevice

IDCompositionDevice::CreateSurface

IDCompositionDevice::CreateSurfaceFromHwnd