Funzione EngLockDirectDrawSurface (winddi.h)
La funzione EngLockDirectDrawSurface blocca l'handle in modalità kernel di una superficie DirectDraw.
Sintassi
ENGAPI PDD_SURFACE_LOCAL EngLockDirectDrawSurface(
[in] HANDLE hSurface
);
Parametri
[in] hSurface
Handle sulla superficie da bloccare.
Valore restituito
EngLockDirectDrawSurface restituisce un puntatore a una struttura DD_SURFACE_LOCAL che descrive le informazioni sulla superficie al termine dell'operazione. In caso contrario, restituisce un puntatore NULL .
Commenti
EngLockDirectDrawSurface consente ai writer del driver di bloccare le superfici DirectDraw. Il blocco dell'handle garantisce il comportamento sincronizzato e mantiene l'handle da eliminare da altri thread nel sistema.
Attualmente, il driver riceve handle di superficie DirectDraw solo dall'interfaccia di texturing Direct3D. Di conseguenza, solo i driver che eseguono il texturing devono bloccare le superfici della trama.
Al termine del texturing, il driver deve rilasciare l'handle bloccato chiamando EngUnlockDirectDrawSurface.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |