IndexBuffer (Constructor) (Device, Int32, Usage, Pool, Boolean)

Artículo
11/26/2008

Actualización: noviembre 2007

Inicializa una nueva instancia de la clase IndexBuffer.

Espacio de nombres: Microsoft.WindowsMobile.DirectX.Direct3D
Ensamblado: Microsoft.WindowsMobile.DirectX (en Microsoft.WindowsMobile.DirectX.dll)

Sintaxis

'Declaración
Public Sub New ( _
    device As Device, _
    sizeOfBufferInBytes As Integer, _
    usage As Usage, _
    pool As Pool, _
    sixteenBitIndices As Boolean _
)
'Uso
Dim device As Device
Dim sizeOfBufferInBytes As Integer
Dim usage As Usage
Dim pool As Pool
Dim sixteenBitIndices As Boolean

Dim instance As New IndexBuffer(device, _
    sizeOfBufferInBytes, usage, pool, _
    sixteenBitIndices)

public IndexBuffer(
    Device device,
    int sizeOfBufferInBytes,
    Usage usage,
    Pool pool,
    bool sixteenBitIndices
)

public:
IndexBuffer(
    Device^ device, 
    int sizeOfBufferInBytes, 
    Usage usage, 
    Pool pool, 
    bool sixteenBitIndices
)

public function IndexBuffer(
    device : Device, 
    sizeOfBufferInBytes : int, 
    usage : Usage, 
    pool : Pool, 
    sixteenBitIndices : boolean
)

Parámetros

device
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Device
Objeto Device que se va a asociar al búfer de índice.

sizeOfBufferInBytes
Tipo: System.Int32
Tamaño del búfer de índice, en bytes.

usage
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Usage
Puede ser 0, que indica que no hay ningún valor de uso. Sin embargo, si desea utilizarlo, emplee una combinación de uno o más indicadores Usage. Se recomienda hacer coincidir el parámetro usage con los indicadores de comportamiento del constructor Device.

pool
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Pool
Miembro del tipo enumerado Pool que describe una clase de memoria válida en la que colocar el recurso.

sixteenBitIndices
Tipo: System.Boolean
Se establece en true si el búfer de índice contiene índices de 16 bits. Se establece en false si el búfer de índice contiene índices de 32 bits.

Excepciones

Excepción	Condición
InvalidCallException	La llamada al método no es válida. Por ejemplo, un parámetro del método puede contener un valor que no es válido.
OutOfMemoryException	Direct3D no tiene memoria de presentación suficiente para realizar la operación.

Comentarios

Los búferes de índice son recursos de memoria utilizados para contener los índices. Son similares a las superficies y búferes de vértice. El uso de búferes de índice permite a Direct3D evitar la copia innecesaria de datos y asignar al búfer el tipo de memoria óptimo para el uso esperado.

Para utilizar un búfer de índice:

Cree un búfer de índice.
Bloquee el búfer de índice, llénelo de índices y, a continuación, desbloquéelo.
Pase el búfer de índice a la propiedad Indices de Device.
Configure los vértices y el shader de vértice.
Llame al método DrawIndexedPrimitives en el objeto Device que se va a representar.

La propiedad MaxVertexIndex de una estructura Caps indica el valor máximo de un índice que se puede utilizar en un búfer de índice.

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Plataformas

Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.