Función NtGdiDdCreateSurfaceObject
[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.
Crea un objeto de superficie en modo kernel que representa el objeto de superficie en modo de usuario al que hace referencia puSurfaceLocal.
Sintaxis
HANDLE APIENTRY NtGdiDdCreateSurfaceObject(
_In_ HANDLE hDirectDrawLocal,
_In_ HANDLE hSurface,
_In_ PDD_SURFACE_LOCAL puSurfaceLocal,
_In_ PDD_SURFACE_MORE puSurfaceMore,
_In_ PDD_SURFACE_GLOBAL puSurfaceGlobal,
_In_ BOOL bComplete
);
Parámetros
-
hDirectDrawLocal [in]
-
Identificador del objeto DirectDraw en modo kernel.
-
hSurface [in]
-
Identificador anterior a la misma superficie. Se usa si la superficie se vuelve a crear después de un modificador de modo.
-
puSurfaceLocal [in]
-
Puntero a la estructura DD_SURFACE_LOCAL que representa el objeto de superficie del modo de usuario de DirectDraw con el que se va a asociar la memoria asignada. Consulte la documentación de DDK para obtener más información.
-
puSurfaceMore [in]
-
Puntero a la estructura DD_SURFACE_MORE que contiene datos locales adicionales para cada objeto de superficie individual. Consulte la documentación de DDK para obtener más información.
-
puSurfaceGlobal [in]
-
Puntero a la estructura DD_SURFACE_GLOBAL que contiene datos de superficie compartidos globalmente con varias superficies. Consulte la documentación de DDK para obtener más información.
-
bComplete [in]
-
Marca de finalización de objetos en modo kernel. Puede ser uno de los valores siguientes.
-
(TRUE)
-
Complete todo el procesamiento relativo a la representación en modo kernel.
-
(FALSE)
-
Cree el objeto, pero no configure datos internos, como el puntero de memoria. Los objetos creados con FALSE se pueden adjuntar mediante NtGdiDdAttachSurface y se completan mediante una llamada a NtGdiDdCreateSurface.
Valor devuelto
Si se ejecuta correctamente, esta función devuelve un identificador a la representación de superficie en modo kernel; de lo contrario, devuelve NULL.
Comentarios
Se recomienda que las aplicaciones usen las API de DirectDraw y Direct3D para crear y administrar objetos de dispositivo gráficos. Estas construcciones abstraen el proceso de creación de dispositivos de forma simplificada e independiente del sistema operativo.
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