Método IDirect3DDevice9::D rawPrimitiveUP (d3d9helper.h)
Renderiza dados especificados por um ponteiro de memória do usuário como uma sequência de primitivos geométricos do tipo especificado.
Sintaxe
HRESULT DrawPrimitiveUP(
[in] D3DPRIMITIVETYPE PrimitiveType,
[in] UINT PrimitiveCount,
[in] const void *pVertexStreamZeroData,
[in] UINT VertexStreamZeroStride
);
Parâmetros
[in] PrimitiveType
Tipo: D3DPRIMITIVETYPE
Membro do D3DPRIMITIVETYPE tipo enumerado, descrevendo o tipo de primitivo a ser renderizado.
[in] PrimitiveCount
Tipo: UINT
Número de primitivos a serem renderizados. O número máximo de primitivos permitido é determinado verificando o membro MaxPrimitiveCount da estrutura D3DCAPS9 .
[in] pVertexStreamZeroData
Tipo: const void*
Ponteiro de memória do usuário para os dados de vértice.
[in] VertexStreamZeroStride
Tipo: UINT
O número de bytes de dados para cada vértice. Esse valor pode não ser 0.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser: D3DERR_INVALIDCALL.
Comentários
Esse método destina-se ao uso em aplicativos que não podem armazenar seus dados de vértice em buffers de vértice. Esse método dá suporte apenas a um único fluxo de vértice. O efeito dessa chamada é usar o ponteiro de dados de vértice fornecido e o passo a passo para o fluxo de vértice 0. É inválido que a declaração do sombreador de vértice atual se refira a fluxos de vértice diferentes do fluxo 0.
Seguindo qualquer chamada IDirect3DDevice9::D rawPrimitiveUP , as configurações do fluxo 0, referenciadas por IDirect3DDevice9::GetStreamSource, são definidas como NULL.
Os dados de vértice passados para IDirect3DDevice9::D rawPrimitiveUP não precisam persistir após a chamada. O Direct3D conclui seu acesso a esses dados antes de retornar da chamada.
Ao converter um aplicativo herdado no Direct3D 9, você deve adicionar uma chamada a IDirect3DDevice9::SetFVF para usar o pipeline de função fixa ou IDirect3DDevice9::SetVertexDeclaration para usar um sombreador de vértice antes de fazer chamadas de Desenho.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | d3d9helper.h (inclua D3D9.h) |
| Biblioteca | D3D9.lib |