Fonction EngCreateDeviceSurface (winddi.h)
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 |