EngLockDirectDrawSurface-Funktion (winddi.h)
Die EngLockDirectDrawSurface-Funktion sperrt das Kernelmodushandle einer DirectDraw-Oberfläche.
Syntax
ENGAPI PDD_SURFACE_LOCAL EngLockDirectDrawSurface(
[in] HANDLE hSurface
);
Parameter
[in] hSurface
Ziehpunkt auf die zu sperrende Oberfläche.
Rückgabewert
EngLockDirectDrawSurface gibt einen Zeiger auf eine DD_SURFACE_LOCAL-Struktur zurück, die die Oberflächeninformationen bei Erfolg beschreibt. Andernfalls wird ein NULL-Zeiger zurückgegeben.
Hinweise
EngLockDirectDrawSurface ermöglicht Treiberschreibern das Sperren von DirectDraw-Oberflächen. Das Sperren des Handles garantiert synchronisiertes Verhalten und behält das Handle vor dem Löschen durch andere Threads im System bei.
Derzeit empfängt der Treiber DirectDraw-Oberflächenhandles nur von der Direct3D-Texturierungsschnittstelle. Folglich müssen nur Treiber, die Texturing ausführen, Texturoberflächen sperren.
Nach Abschluss der Texturierung muss der Treiber das gesperrte Handle durch Aufrufen von EngUnlockDirectDrawSurface freigeben.
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 |