Método IDirect3DDevice9::CreateIndexBuffer (d3d9helper.h)

Artículo
03/14/2023

Crea un búfer de índice.

Sintaxis

HRESULT CreateIndexBuffer(
  [in]          UINT                  Length,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DIndexBuffer9 **ppIndexBuffer,
  [in]          HANDLE                *pSharedHandle
);

Parámetros

[in] Length

Tipo: UINT

Tamaño del búfer de índice, en bytes.

[in] Usage

Tipo: DWORD

El uso puede ser 0, lo que indica que no hay ningún valor de uso. Sin embargo, si se desea el uso, use una combinación de una o varias constantes D3DUSAGE . Se recomienda hacer coincidir el parámetro de uso en CreateIndexBuffer con las marcas de comportamiento en IDirect3D9::CreateDevice. Para obtener más información, vea la sección Comentarios.

[in] Format

Tipo: D3DFORMAT

Miembro del tipo enumerado D3DFORMAT , que describe el formato del búfer de índice. Para obtener más información, vea la sección Comentarios. La configuración válida es la siguiente:

Elemento	Descripción
D3DFMT_INDEX16	Los índices son de 16 bits cada uno.
D3DFMT_INDEX32	Los índices son de 32 bits cada uno.

[in] Pool

Tipo: D3DPOOL

Miembro del tipo enumerado D3DPOOL , que describe una clase de memoria válida en la que se va a colocar el recurso.

[out, retval] ppIndexBuffer

Tipo: IDirect3DIndexBuffer9**

Dirección de un puntero a una interfaz IDirect3DIndexBuffer9 , que representa el recurso de búfer de índice creado.

[in] pSharedHandle

Tipo: HANDLE*

Este parámetro se puede usar en Direct3D 9 para Windows Vista para compartir recursos; establézcalo en NULL para no compartir un recurso. Este parámetro no se usa en Direct3D 9 para sistemas operativos anteriores a Windows Vista; establézcalo en NULL.

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 puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Comentarios

Los búferes de índice son recursos de memoria que se usan para contener índices, son similares a las superficies y a los búferes de vértices. El uso de búferes de índice permite a Direct3D evitar la copia de datos innecesaria y colocar el búfer en el tipo de memoria óptimo para el uso esperado.

Para usar búferes de índices, cree un búfer de índice, bloqueelo, reblézcalo con índices, páselo a IDirect3DDevice9::SetIndices, configure los vértices, configure el sombreador de vértices y llame a IDirect3DDevice9::D rawIndexedPrimitive para la representación.

El miembro MaxVertexIndex de la estructura D3DCAPS9 indica los tipos de búferes de índice que son válidos para la representación.