The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IDCompositionDevice::CreateSurfaceFromHandle method

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

Syntax

C++


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

Parameters

handle [in]

Type: HANDLE

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

surface [out]

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

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