Compartilhar via


Função EngLockDirectDrawSurface (winddi.h)

A função EngLockDirectDrawSurface bloqueia o identificador do modo kernel de uma superfície DirectDraw.

Sintaxe

ENGAPI PDD_SURFACE_LOCAL EngLockDirectDrawSurface(
  [in] HANDLE hSurface
);

Parâmetros

[in] hSurface

Identificador para a superfície a ser bloqueada.

Retornar valor

EngLockDirectDrawSurface retorna um ponteiro para uma estrutura DD_SURFACE_LOCAL que descreve as informações de superfície após o sucesso. Caso contrário, ele retornará um ponteiro NULL.

Comentários

EngLockDirectDrawSurface permite que os gravadores de driver bloqueiem superfícies do DirectDraw. O bloqueio do identificador garante o comportamento sincronizado e preserva a exclusão do identificador por outros threads no sistema.

Atualmente, o driver recebe identificadores de superfície DirectDraw somente da interface de texturização Direct3D. Consequentemente, somente os drivers que executam texturização precisam bloquear superfícies de textura.

Após a conclusão da texturização, o driver deve liberar o identificador bloqueado chamando EngUnlockDirectDrawSurface.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Universal
Cabeçalho winddi.h (inclua Winddi.h)
Biblioteca Win32k.lib
DLL Win32k.sys

Confira também

DD_SURFACE_LOCAL

EngUnlockDirectDrawSurface