Función NtGdiDdLock

Artículo
06/12/2023

[Esta función está sujeta a cambios con cada revisión del sistema operativo. En su lugar, use Microsoft DirectDraw y Microsoft Direct3DAPIs; estas API aíslan las aplicaciones de estos cambios en el sistema operativo y ocultan muchas otras dificultades implicadas en la interacción directa con los controladores de pantalla.

Bloquea un área especificada de memoria expuesta y proporciona un puntero válido a un bloque de memoria asociado a una superficie.

Sintaxis

DWORD APIENTRY NtGdiDdLock(
  _In_    HANDLE       hSurface,
  _Inout_ PDD_LOCKDATA puLockData,
  _In_    HDC          hdcClip
);

Parámetros

hSurface [in]: Controle a una estructura de DD_SURFACE_LOCAL que describe la superficie asociada a la región de memoria que se va a bloquear.
puLockData [in, out]: Puntero a una estructura de DD_LOCKDATA que contiene la información necesaria para realizar el bloqueo.
hdcClip [in]: Reservado.

Valor devuelto

NtGdiDdLock devuelve uno de los siguientes códigos de devolución de llamada.

Código devuelto	Descripción
DDHAL_DRIVER_HANDLED	El controlador ha realizado la operación y ha devuelto un código de retorno válido para esa operación. Si este código es DD_OK, DirectDraw o Direct3D continúa con la función . De lo contrario, DirectDraw o Direct3D devuelven el código de error proporcionado por el controlador y anula la función.
DDHAL_DRIVER_NOTHANDLED	El controlador no tiene ningún comentario sobre la operación solicitada. Si es necesario que el controlador haya implementado una devolución de llamada determinada, DirectDraw o Direct3D notifican una condición de error. De lo contrario, DirectDraw o Direct3D controlan la operación como si no se hubiera definido la devolución de llamada del controlador mediante la ejecución de la implementación independiente del dispositivo de DirectDraw o Direct3D.

Código devuelto

Descripción

DDHAL_DRIVER_HANDLED

El controlador ha realizado la operación y ha devuelto un código de retorno válido para esa operación. Si este código es DD_OK, DirectDraw o Direct3D continúa con la función . De lo contrario, DirectDraw o Direct3D devuelven el código de error proporcionado por el controlador y anula la función.

DDHAL_DRIVER_NOTHANDLED

El controlador no tiene ningún comentario sobre la operación solicitada. Si es necesario que el controlador haya implementado una devolución de llamada determinada, DirectDraw o Direct3D notifican una condición de error. De lo contrario, DirectDraw o Direct3D controlan la operación como si no se hubiera definido la devolución de llamada del controlador mediante la ejecución de la implementación independiente del dispositivo de DirectDraw o Direct3D.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Ntgdi.h

Consulte también

Compatibilidad con clientes de bajo nivel de gráficos

Share via