Compartir a través de


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

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.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d9.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DDevice9

IDirect3DDevice9::D rawIndexedPrimitive

IDirect3DDevice9::D rawIndexedPrimitiveUP

IDirect3DDevice9::D rawPrimitive

IDirect3DDevice9::D rawPrimitiveUP

IDirect3DDevice9::SetStreamSource

Búferes de vértices (Direct3D 9)