Compartir a través de


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

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.

Requisitos

   
Plataforma de destino Windows
Encabezado d3d9helper.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DDevice9

IDirect3DIndexBuffer9::GetDesc

Búferes de índice (Direct3D 9)