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

Artigo
08/23/2023

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.