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

Artículo
02/28/2024

Recupera un búfer de vértices enlazado al flujo de datos especificado.

Sintaxis

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

Parámetros

StreamNumber

Tipo: [in] UINT

Especifica el flujo de datos, en el intervalo comprendido entre 0 y el número máximo de secuencias menos uno.

ppStreamData

Tipo: [in, out] IDirect3DVertexBuffer9**

Dirección de un puntero a una interfaz IDirect3DVertexBuffer9 , que representa el búfer de vértices devuelto enlazado al flujo de datos especificado.

pOffsetInBytes

Tipo: [out]UINT*

Puntero que contiene el desplazamiento desde el principio de la secuencia hasta el principio de los datos de vértices. El desplazamiento se mide en bytes. Vea la sección Comentarios.

pStride

Tipo: [out] UINT*

Puntero a un intervalo devuelto del componente, en bytes. Vea la sección Comentarios.

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 se puede D3DERR_INVALIDCALL.

Comentarios

Una secuencia se define como una matriz uniforme de datos de componentes, donde cada componente consta de uno o varios elementos que representan una sola entidad, como posición, normal, color, etc.

Cuando se usa un sombreador de vértices FVF, el paso de la secuencia de vértices debe coincidir con el tamaño del vértice, calculado desde el FVF. Cuando se usa una declaración, el intervalo debe ser mayor o igual que el tamaño de flujo calculado a partir de la declaración.

Llamar a este método aumenta el recuento de referencias internas en la interfaz IDirect3DVertexBuffer9 . Si no se llama a IUnknown::Release cuando termine de usar esta interfaz IDirect3DVertexBuffer9 , se producirá una pérdida de memoria.