Método IDirect3DDevice9::GetStreamSource (d3d9.h)

Artigo
08/23/2023

Recupera um buffer de vértice associado ao fluxo de dados especificado.

Sintaxe

HRESULT GetStreamSource(
  UINT                   StreamNumber,
  IDirect3DVertexBuffer9 **ppStreamData,
  UINT                   *pOffsetInBytes,
  UINT                   *pStride
);

Parâmetros

StreamNumber

Tipo: [in] UINT

Especifica o fluxo de dados, no intervalo de 0 até o número máximo de fluxos menos um.

ppStreamData

Tipo: [in, out] IDirect3DVertexBuffer9**

Endereço de um ponteiro para uma interface IDirect3DVertexBuffer9 , representando o buffer de vértice retornado associado ao fluxo de dados especificado.

pOffsetInBytes

Tipo: [out]UINT*

Ponteiro que contém o deslocamento do início do fluxo até o início dos dados de vértice. O deslocamento é medido em bytes. Consulte Observações.

pStride

Tipo: [out] UINT*

Ponteiro para um passo retornado do componente, em bytes. Consulte Observações.

Valor retornado

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

Um fluxo é definido como uma matriz uniforme de dados de componente, em que cada componente consiste em um ou mais elementos que representam uma única entidade, como posição, normal, cor e assim por diante.

Quando um sombreador de vértice FVF é usado, o passo do fluxo de vértice deve corresponder ao tamanho do vértice, calculado a partir do FVF. Quando uma declaração é usada, o passo a passo deve ser maior ou igual ao tamanho do fluxo calculado da declaração.

Chamar esse método aumenta a contagem de referência interna na interface IDirect3DVertexBuffer9 . Falha ao chamar IUnknown::Release quando terminar de usar essa interface IDirect3DVertexBuffer9 resulta em uma perda de memória.