Función NtGdiDdCreateD3DBuffer
[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.
Se usa para crear un comando de nivel de controlador o un búfer de vértices de la descripción especificada.
Sintaxis
DWORD APIENTRY NtGdiDdCreateD3DBuffer(
_In_ HANDLE hDirectDraw,
_Inout_ HANDLE *hSurface,
_Inout_ DDSURFACEDESC *puSurfaceDescription,
_Inout_ DD_SURFACE_GLOBAL *puSurfaceGlobalData,
_Inout_ DD_SURFACE_LOCAL *puSurfaceLocalData,
_Inout_ DD_SURFACE_MORE *puSurfaceMoreData,
_Inout_ DD_CREATESURFACEDATA *puCreateSurfaceData,
_Inout_ HANDLE *puhSurface
);
Parámetros
-
hDirectDraw [in]
-
Identificador de la estructura DD_DIRECTDRAW_GLOBAL que representa el controlador.
-
hSurface [in, out]
-
Puntero a una matriz de identificadores de superficie. El autor de la llamada puede establecer estos identificadores en los valores de identificador anteriores si las superficies se vuelven a crear después de un modificador de modo. Este proceso se denomina "restauración" en la documentación de DirectDraw.
-
puSurfaceDescription [in, out]
-
Puntero a una estructura DDSURFACEDESC que describe la superficie o el búfer que debe crear el controlador.
-
puSurfaceGlobalData [in, out]
-
Puntero a una estructura de DD_SURFACE_GLOBAL que contiene datos de superficie que se comparten globalmente con varias superficies.
-
puSurfaceLocalData [in, out]
-
Puntero a una lista de DD_SURFACE_LOCAL estructuras que describen los objetos de superficie creados por el controlador. Normalmente, solo hay una entrada en esta matriz.
-
puSurfaceMoreData [in, out]
-
Puntero a una estructura de DD_SURFACE_MORE que contiene datos de superficie locales adicionales.
-
puCreateSurfaceData [in, out]
-
Puntero a una estructura de DD_CREATESURFACEDATA que contiene la información necesaria para crear el búfer.
-
puhSurface [in, out]
-
La API de DirectDraw la usa y el controlador no debe rellenarlo.
Valor devuelto
NtGdiDdCreateD3DBuffer 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 anula la función. |
|
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 |
|
Consulte también