Función NtGdiD3DDrawPrimitives2

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

Representa primitivos y devuelve el estado de representación actualizado.

Sintaxis

DWORD APIENTRY NtGdiD3DDrawPrimitives2(
  _In_    HANDLE                         hCmdBuf,
  _In_    HANDLE                         hVBuf,
  _Inout_ LPD3DNTHAL_DRAWPRIMITIVES2DATA pded,
  _Inout_ FLATPTR                        *pfpVidMemCmd,
  _Inout_ DWORD                          *pdwSizeCmd,
  _Inout_ FLATPTR                        *pfpVidMemVtx,
  _Inout_ DWORD                          *pdwSizeVtx
);

Parámetros

hCmdBuf [in]

Controle la estructura DD_SURFACE_LOCAL que identifica la superficie de DirectDraw que contiene los datos del comando.

hVBuf [in]

Controle la estructura DD_SURFACE_LOCAL que identifica la superficie de DirectDraw que contiene los datos de vértice.

pded [in, out]

Puntero a una estructura D3DNTHAL_DRAWPRIMITIVES2DATA que contiene la información necesaria para que el controlador represente uno o varios primitivos.

pfpVidMemCmd [in, out]

Nuevo puntero a la memoria de vídeo si el controlador ha intercambiado el búfer de comandos.

pdwSizeCmd [in, out]

Especifica el número mínimo de bytes por los que el controlador debe aumentar el búfer de comandos de intercambio.

pfpVidMemVtx [in, out]

Nuevo puntero a la memoria de vídeo si el controlador ha intercambiado el búfer de vértices.

pdwSizeVtx [in, out]

Especifica el número mínimo de bytes que el controlador debe asignar para el búfer de vértices de intercambio.

Valor devuelto

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

 

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