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

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 ( _
    typeIndexType As Type, _
    numberIndices As Integer, _
    device As Device, _
    usage As Usage, _
    pool As Pool _
)
'Uso
Dim typeIndexType As Type
Dim numberIndices As Integer
Dim device As Device
Dim usage As Usage
Dim pool As Pool

Dim instance As New IndexBuffer(typeIndexType, _
    numberIndices, device, usage, pool)

public IndexBuffer(
    Type typeIndexType,
    int numberIndices,
    Device device,
    Usage usage,
    Pool pool
)

public:
IndexBuffer(
    Type^ typeIndexType, 
    int numberIndices, 
    Device^ device, 
    Usage usage, 
    Pool pool
)

public function IndexBuffer(
    typeIndexType : Type, 
    numberIndices : int, 
    device : Device, 
    usage : Usage, 
    pool : Pool
)

Parámetros

typeIndexType
Tipo: System.Type
Type que indica el tipo de datos de índice que contiene el búfer. Puede ser un tipo de valor o cualquier tipo que contenga sólo tipos de valor.

numberIndices
Tipo: System.Int32
Número máximo de índices que puede contener el búfer.

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

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.

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, realice los pasos siguientes:

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.