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 |