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

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header dcomp.h
Library Dcomp.lib
DLL Dcomp.dll

See also

IDCompositionDevice

IDCompositionDevice::CreateSurface

IDCompositionDevice::CreateSurfaceFromHwnd