Compartir a través de

Método IDirect3DDevice9::D rawPrimitiveUP (d3d9.h)

  • Artículo

Representa los datos especificados por un puntero de memoria de usuario como una secuencia de primitivos geométricos del tipo especificado.

Sintaxis

HRESULT DrawPrimitiveUP(
  [in] D3DPRIMITIVETYPE PrimitiveType,
  [in] UINT             PrimitiveCount,
  [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] 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 .

[in] pVertexStreamZeroData

Tipo: const void*

Puntero de memoria del usuario a los datos de vértices.

[in] VertexStreamZeroStride

Tipo: UINT

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

Valor devuelto

Tipo: HRESULT

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

Comentarios

Este método está diseñado 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értices. El efecto de esta llamada es usar el puntero de datos de vértice y el paso proporcionados para la secuencia de vértices 0. No es válido que la declaración del sombreador de vértices actual haga referencia a secuencias de vértices distintas de la secuencia 0.

Siguiendo cualquier llamada IDirect3DDevice9::D rawPrimitiveUP , la configuración de stream 0, a la que hace referencia IDirect3DDevice9::GetStreamSource, se establece en NULL.

Los datos de vértice pasados a IDirect3DDevice9::D rawPrimitiveUP 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, debes agregar una llamada a IDirect3DDevice9::SetFVF para usar la canalización de función fija o IDirect3DDevice9::SetVertexDeclaration para usar un sombreador de vértices antes de realizar llamadas a Draw.

Requisitos

   
Plataforma de destino Windows
Encabezado d3d9.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DDevice9

IDirect3DDevice9::D rawIndexedPrimitiveUP

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