Compartir a través de


Función NtGdiD3DContextCreate

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

Sintaxis

BOOL APIENTRY NtGdiD3DContextCreate(
  _In_    HANDLE                  hDirectDrawLocal,
  _In_    HANDLE                  hSurfColor,
  _In_    HANDLE                  hSurfZ,
  _Inout_ D3DNTHAL_CONTEXTCREATEI *pdcci
);

Parámetros

hDirectDrawLocal [in]

Controle un objeto DirectDraw en modo kernel, creado anteriormente con NtGdiDdCreateDirectDrawObject, que representa el dispositivo en el que se va a crear el contexto de Direct3D.

hSurfColor [in]

Controlar en una estructura de DD_SURFACE_LOCAL que describe la superficie de DirectDraw que se va a usar como destino de representación.

hSurfZ [in]

Controlar en una estructura de DD_SURFACE_LOCAL que describe la superficie de DirectDraw que se va a usar como búfer de profundidad. Si este miembro es NULL, no se realizará ningún almacenamiento en búfer de profundidad.

pdcci [in, out]

Puntero a una estructura de D3DNTHAL_CONTEXTCREATEDATA que contiene la información necesaria para crear un contexto y los datos que el controlador debe almacenar en el nuevo contexto.

Valor devuelto

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

 

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