estructura D3DHAL_DRAWPRIMITIVES2DATA (d3dhal.h)

La estructura D3DHAL_DRAWPRIMITIVES2DATA contiene la información requerida por la función D3dDrawPrimitives2 para representar primitivos.

Sintaxis

typedef struct _D3DHAL_DRAWPRIMITIVES2DATA {
  ULONG_PTR                 dwhContext;
  DWORD                     dwFlags;
  DWORD                     dwVertexType;
  LPDDRAWI_DDRAWSURFACE_LCL lpDDCommands;
  DWORD                     dwCommandOffset;
  DWORD                     dwCommandLength;
  union {
    LPDDRAWI_DDRAWSURFACE_LCL lpDDVertex;
    LPVOID                    lpVertices;
  };
  DWORD                     dwVertexOffset;
  DWORD                     dwVertexLength;
  DWORD                     dwReqVertexBufSize;
  DWORD                     dwReqCommandBufSize;
  LPDWORD                   lpdwRStates;
  union {
    DWORD   dwVertexSize;
    HRESULT ddrval;
  };
  DWORD                     dwErrorOffset;
} D3DHAL_DRAWPRIMITIVES2DATA;

Miembros

dwhContext

Especifica el identificador de contexto del dispositivo Direct3D.

dwFlags

Especifica marcas que proporcionan instrucciones adicionales al controlador o proporcionan información del controlador. Este miembro puede ser un OR bit a bit de los siguientes valores:

dwVertexType

Identifica el FVF de los datos en el búfer de vértices; es decir, dwVertexType especifica a qué campos de datos por vértice están presentes en el búfer de vértices al que apunta lpDDVertex o lpVertices . Este miembro puede ser un OR bit a bit de los valores de la tabla siguiente. Solo se establece una de las marcas de D3DFVF_TEXx .

lpDDCommands

dwCommandOffset

dwCommandLength

Especifica el número de bytes de datos de comandos válidos en la superficie que lpDDCommands apunta a a partir de dwCommandOffset.

lpDDVertex

Apunta a la estructura DD_SURFACE_LOCAL que identifica la superficie de DirectDraw que contiene los datos de vértice cuando la marca de D3DHALDP2_USERMEMVERTICES no está establecida en dwFlags. Forma una unión con lpVertices.

lpVertices

Apunta a un bloque de memoria en modo de usuario que contiene datos de vértices cuando la marca D3DHALDP2_USERMEMVERTICES se establece en dwFlags.

dwVertexOffset

Especifica el número de bytes en la superficie a la que apunta lpDDVertex o lpVertices donde comienzan los datos del vértice.

dwVertexLength

Especifica el número de vértices para los que existen datos válidos en la superficie a la que apunta lpDDVertex o lpVertices. Estos datos válidos comienzan en dwVertexOffset.

dwReqVertexBufSize

Especifica el número mínimo de bytes que el controlador debe asignar para el búfer de vértices de intercambio. Este miembro solo es válido cuando se establece la marca D3DHALDP2_REQVERTEXBUFSIZE. Los controladores que no admiten el multibúfer de búferes de vértices deben omitir este miembro.

dwReqCommandBufSize

Especifica el número mínimo de bytes por los que el controlador debe aumentar el búfer de comandos de intercambio. Este miembro solo es válido cuando se establece la marca D3DHALDP2_REQCOMMANDBUFSIZE. Los controladores que no admiten el multibuffering de búferes de comandos deben omitir este miembro.

lpdwRStates

Apunta a una matriz de estado de representación que el controlador debe actualizar cuando analiza los comandos de estado de representación del búfer de comandos. El controlador solo debe actualizar esta matriz cuando la marca D3DHALDP2_EXECUTEBUFFER está establecida en dwFlags. El controlador debe usar el D3DRENDERSTATETYPE tipos enumerados para actualizar el elemento adecuado de la matriz de estado de representación.

dwVertexSize

Especifica el tamaño de cada vértice, en bytes. Este miembro forma una unión con ddrval.

ddrval

Especifica la ubicación donde el controlador escribe el valor devuelto de D3dDrawPrimitives2. D3D_OK indica que se ha realizado correctamente. De lo contrario, el controlador debe devolver el código de error D3DERR_Xxx adecuado. Para obtener más información, consulta Códigos de retorno para devoluciones de llamada del controlador de Direct3D.

dwErrorOffset

Cada D3DHAL_DP2RESPONSEQUERY va seguida de los siguientes datos relacionados con la consulta:

• BOOL para D3DQUERYTYPE_EVENT
• DWORD para D3DQUERYTYPE_OCCLUSION
• estructura de D3DDEVINFO_VCACHE para D3DQUERYTYPE_VCACHE

Comentarios

Tenga en cuenta que el miembro dwVertexOffset especifica valores en bytes; El miembro dwVertexLength especifica valores en vértices.

Para calcular los datos válidos, en bytes, que existen en la superficie en lpDDVertex o lpVertices, multiplique el valor en dwVertexLength por el valor de dwVertexSize.

Requisitos

Consulte también

D3DHAL_DP2COMMAND

D3DRENDERSTATETYPE

D3dDrawPrimitives2

DD_SURFACE_GLOBAL

DD_SURFACE_LOCAL