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

Weitere Informationen

DD_SURFACE_LOCAL

EngUnlockDirectDrawSurface