EngCreateDeviceSurface-Funktion (winddi.h)
Die EngCreateDeviceSurface-Funktion erstellt und gibt einen Handle für eine Geräteoberfläche zurück, die vom Treiber verwaltet wird.
Syntax
ENGAPI HSURF EngCreateDeviceSurface(
[in] DHSURF dhsurf,
[in] SIZEL sizl,
ULONG iFormatCompat
);
Parameter
[in] dhsurf
Gerätehandle auf der Oberfläche, die vom Gerät verwaltet werden soll. Dieses Handle wird an den Treiber übergeben, wenn eine SURFOBJ-Struktur für die Eingabe oder Ausgabe übergeben wird.
[in] sizl
Gibt eine SIZEL-Struktur an, die die Breite und Höhe der zu erstellenden Oberfläche enthält. Die Elemente cx und cy dieser Struktur enthalten jeweils die Breite und Höhe der Oberfläche in Pixel. Eine SIZEL-Struktur ist mit einer SIZE-Struktur identisch.
iFormatCompat
Gibt das kompatible Modulformat der zu erstellenden Geräteoberfläche an. Dies wird von GDI verwendet, wenn ein temporärer Puffer erforderlich ist, um einen komplizierten Zeichnungsaufruf zu simulieren.
Rückgabewert
Der Rückgabewert ist ein Handle, das die Oberfläche identifiziert, wenn die Funktion erfolgreich ist. Andernfalls ist er 0, und ein Fehlercode wird protokolliert.
Hinweise
Der Speicherplatz für das Surface kann optional vom Treiber bereitgestellt werden. Die Oberfläche sollte mithilfe von EngAssociateSurface zugeordnet werden. Die Oberfläche sollte gelöscht werden, wenn sie nicht mehr benötigt wird, indem Sie EngDeleteSurface verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | winddi.h (einschließlich Winddi.h) |
| Bibliothek | Win32k.lib |
| DLL | Win32k.sys |