Fonction EngCreateDeviceSurface (winddi.h)

  • Article

La fonction EngCreateDeviceSurface crée et retourne un handle pour une surface d’appareil que le pilote gérera.

Syntaxe

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

Paramètres

[in] dhsurf

Handle d’appareil sur la surface à gérer par l’appareil. Ce handle est passé au pilote lorsqu’une structure SURFOBJ est transmise pour l’entrée ou la sortie.

[in] sizl

Spécifie une structure SIZEL qui contient la largeur et la hauteur de la surface à créer. Les membres cx et cy de cette structure contiennent respectivement la largeur et la hauteur de la surface, en pixels. Une structure SIZEL est identique à une structure SIZE .

iFormatCompat

Spécifie le format de moteur compatible de la surface d’appareil en cours de création. Il est utilisé par GDI si une mémoire tampon temporaire est nécessaire pour simuler un appel de dessin compliqué.

Valeur retournée

La valeur de retour est un handle qui identifie la surface si la fonction réussit. Sinon, il est égal à zéro et un code d’erreur est journalisé.

Remarques

L’espace de stockage de la surface peut éventuellement être fourni par le pilote. La surface doit être associée à l’aide de EngAssociateSurface. La surface doit être supprimée lorsqu’elle n’est plus nécessaire à l’aide de EngDeleteSurface.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Universal
En-tête winddi.h (inclure Winddi.h)
Bibliothèque Win32k.lib
DLL Win32k.sys

Voir aussi

EngAssociateSurface

EngDeleteSurface

SURFOBJ