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

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 de usuario a los datos de vértices.

[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: 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értices. El efecto de esta llamada es usar el puntero de datos de vértice proporcionado y el paso 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, 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 rawIndexedPrimitiveUP

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