Skip to content

Latest commit

 

History

History
87 lines (64 loc) · 3.15 KB

nf-winddi-engcreatedevicesurface.md

File metadata and controls

87 lines (64 loc) · 3.15 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winddi.EngCreateDeviceSurface
EngCreateDeviceSurface function (winddi.h)
The EngCreateDeviceSurface function creates and returns a handle for a device surface that the driver will manage.
EngCreateDeviceSurface
EngCreateDeviceSurface function [Display Devices]
display.engcreatedevicesurface
gdifncs_0a48d849-3e93-4310-87e1-cd0b6882b4a4.xml
winddi/EngCreateDeviceSurface
display\engcreatedevicesurface.htm
display
9c3ca4c4-7614-4739-8333-202c6ec2eab8
12/05/2018
EngCreateDeviceSurface, EngCreateDeviceSurface function [Display Devices], display.engcreatedevicesurface, gdifncs_0a48d849-3e93-4310-87e1-cd0b6882b4a4.xml, winddi/EngCreateDeviceSurface
winddi.h
Winddi.h
Universal
Available in Windows 2000 and later versions of the Windows operating systems.
Win32k.lib
Win32k.sys
Windows
19H1
EngCreateDeviceSurface
winddi/EngCreateDeviceSurface
c++
APIRef
kbSyntax
DllExport
Win32k.sys
EngCreateDeviceSurface

EngCreateDeviceSurface function

-description

The EngCreateDeviceSurface function creates and returns a handle for a device surface that the driver will manage.

-parameters

-param dhsurf [in]

Device handle to the surface to be managed by the device. This handle is passed to the driver when a SURFOBJ structure is passed for input or output.

-param sizl [in]

Specifies a SIZEL structure that contains the width and height of the surface to be created. The cx and cy members of this structure contain respectively, the surface's width and height, in pixels. A SIZEL structure is identical to a SIZE structure.

-param iFormatCompat

Specifies the compatible engine format of the device surface being created. This is used by GDI if a temporary buffer is needed to simulate a complicated drawing call.

-returns

The return value is a handle that identifies the surface if the function is successful. Otherwise, it is zero, and an error code is logged.

-remarks

The storage space for the surface can optionally be provided by the driver. The surface should be associated by using EngAssociateSurface. The surface should be deleted when it is no longer needed by using EngDeleteSurface.

-see-also

EngAssociateSurface

EngDeleteSurface

SURFOBJ