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 |
|---|---|
|
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. |
|
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 |
|
Consulte también