Método IDirect3DDevice9::D rawIndexedPrimitiveUP (d3d9helper.h)

  • Artículo

Representa el primitivo geométrico especificado con datos especificados por un puntero de memoria de usuario.

Sintaxis

HRESULT DrawIndexedPrimitiveUP(
  [in] D3DPRIMITIVETYPE PrimitiveType,
  [in] UINT             MinVertexIndex,
  [in] UINT             NumVertices,
  [in] UINT             PrimitiveCount,
  [in] const void       *pIndexData,
  [in] D3DFORMAT        IndexDataFormat,
  [in] const void       *pVertexStreamZeroData,
  [in] UINT             VertexStreamZeroStride
);

Parámetros

[in] PrimitiveType

Tipo: D3DPRIMITIVETYPE

Miembro del tipo enumerado D3DPRIMITIVETYPE , que describe el tipo de primitivo que se va a representar.

[in] MinVertexIndex

Tipo: UINT

Índice mínimo de vértices. Se trata de un índice de base cero.

[in] NumVertices

Tipo: UINT

Número de vértices usados durante esta llamada. El primer vértice se encuentra en el índice: MinVertexIndex.

[in] PrimitiveCount

Tipo: UINT

Número de primitivos que se van a representar. El número máximo de primitivos permitidos se determina comprobando el miembro MaxPrimitiveCount de la estructura D3DCAPS9 (el número de índices es una función del recuento primitivo y el tipo primitivo).

[in] pIndexData

Tipo: const void*

Puntero de memoria de usuario a los datos de índice.

[in] IndexDataFormat

Tipo: D3DFORMAT

Miembro del tipo enumerado D3DFORMAT , que describe el formato de los datos de índice. La configuración válida es:

[in] pVertexStreamZeroData

Tipo: const void*

Puntero de memoria de usuario a los datos de vértices. Los datos del vértice deben estar en la secuencia 0.

[in] VertexStreamZeroStride

Tipo: UINT

Número de bytes de datos para cada vértice. Este valor puede no ser 0.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser el siguiente: D3DERR_INVALIDCALL.

Comentarios

Este método está pensado para su uso en aplicaciones que no pueden almacenar sus datos de vértices en búferes de vértices. Este método solo admite una secuencia de vértice única, que debe declararse como secuencia 0.

Siguiendo cualquier llamada IDirect3DDevice9::D rawIndexedPrimitiveUP , la configuración de stream 0, a la que hace referencia IDirect3DDevice9::GetStreamSource, se establece en NULL. Además, la configuración del búfer de índice para IDirect3DDevice9::SetIndices se establece en NULL.

Los datos de vértice pasados a IDirect3DDevice9::D rawIndexedPrimitiveUP no necesitan conservarse después de la llamada. Direct3D completa su acceso a esos datos antes de volver desde la llamada.

Al convertir una aplicación heredada en Direct3D 9, debe agregar una llamada a IDirect3DDevice9::SetFVF para usar la canalización de funciones fijas o IDirect3DDevice9::SetVertexDeclaration para usar un sombreador de vértices antes de realizar llamadas a Draw.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d9helper.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DDevice9

IDirect3DDevice9::D rawPrimitive

Representación desde búferes de vértices e índices (Direct3D 9)