Función NtGdiDdUnattachSurface

[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.

Quita un archivo adjunto, creado con NtGdiDdAttachSurface, entre dos objetos de superficie en modo kernel.

Sintaxis

VOID APIENTRY NtGdiDdUnattachSurface(
  _In_ HANDLE hSurface,
  _In_ HANDLE hSurfaceAttached
);

Parámetros

hSurface [in]

Objeto de superficie en modo kernel que se pasó como el parámetro hSurfaceFrom a NtGdiDdAttachSurface.

hSurfaceAttached [in]

Objeto de superficie en modo kernel que se pasó como parámetro hSurfaceTo a NtGdiDdAttachSurface

Valor devuelto

NtGdiDdUnattachSurface 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 anulan la función.
DDHAL_DRIVER_NOTHANDLED	El controlador no tiene ningún comentario sobre la operación solicitada. Si se requiere 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 controla 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.

 

Comentarios

Se recomienda que las aplicaciones usen directDraw API, que controla los datos adjuntos de superficie de forma más alta.

No es necesario llamar a esta función porque el kernel destruirá automáticamente todos los datos adjuntos cuando se llame a NtGdiDdDestroySurface .

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