EngLockDirectDrawSurface, fonction (winddi.h)
La fonction EngLockDirectDrawSurface verrouille le handle en mode noyau d’une surface DirectDraw.
Syntaxe
ENGAPI PDD_SURFACE_LOCAL EngLockDirectDrawSurface(
[in] HANDLE hSurface
);
Paramètres
[in] hSurface
Handle à la surface à verrouiller.
Valeur retournée
EngLockDirectDrawSurface retourne un pointeur vers une structure DD_SURFACE_LOCAL qui décrit les informations de surface en cas de réussite. Sinon, elle retourne un pointeur NULL .
Remarques
EngLockDirectDrawSurface permet aux enregistreurs de pilotes de verrouiller les surfaces DirectDraw. Le verrouillage du handle garantit le comportement synchronisé et empêche la suppression du handle par d’autres threads du système.
Actuellement, le pilote reçoit les poignées de surface DirectDraw uniquement à partir de l’interface de texturation Direct3D. Par conséquent, seuls les pilotes qui effectuent la texturation doivent verrouiller les surfaces de texture.
Une fois la texturation terminée, le pilote doit libérer le handle verrouillé en appelant EngUnlockDirectDrawSurface.
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 |