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

Articolo
09/12/2008

Aggiornamento: novembre 2007

Inizializza una nuova istanza della classe IndexBuffer.

Spazio dei nomi: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Sintassi

'Dichiarazione
Public Sub New ( _
    typeIndexType As Type, _
    numberIndices As Integer, _
    device As Device, _
    usage As Usage, _
    pool As Pool _
)
'Utilizzo
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
)

Parametri

typeIndexType
Tipo: System.Type

Oggetto Type che indica il tipo dei dati di indice contenuti nel buffer. Può trattarsi di un tipo di valore o di qualsiasi tipo che contenga soltanto tipi di valore.

numberIndices
Tipo: System.Int32

Numero massimo di indici che il buffer può contenere.

device
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Device

Oggetto Device da associare al buffer indice.

usage
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Usage

L'utilizzo può essere 0, che non indica alcun valore di utilizzo. Tuttavia, se si desidera specificare l'utilizzo, utilizzare una combinazione di uno o più flag Usage. È consigliabile che il parametro usage nel costruttore coincida ai flag di comportamento nel costruttore Device.

pool
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Pool

Membro del tipo enumerato Pool che descrive una classe di memoria valida in cui inserire la risorsa.

Eccezioni

Eccezione	Condizione
InvalidCallException	La chiamata al metodo non è valida. Il parametro di un metodo potrebbe, ad esempio, contenere un valore non valido.
OutOfMemoryException	In Direct3D non è disponibile una quantità sufficiente di memoria di visualizzazione per eseguire l'operazione.

Note

I buffer indice sono risorse di memoria utilizzate per contenere gli indici. Sono simili alle superfici e ai vertex buffer. In Direct3D, l'utilizzo dei buffer indice consente di evitare la copia di dati non necessari e di inserire il buffer nel tipo di memoria ottimale per l'utilizzo previsto.

Per utilizzare un buffer indice, effettuare le seguenti operazioni:

Creare un buffer indice.
Bloccare il buffer indice, inserirvi gli indici, quindi sbloccarlo.
Passare il buffer indice alla proprietà Indices di un oggetto Device.
Impostare i vertici e il vertex shader.
Chiamare il metodo DrawIndexedPrimitives sull'oggetto Device per eseguire il rendering.

MaxVertexIndex di Caps indica il valore massimo di un indice che può essere utilizzato in un buffer indice.

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Piattaforme

Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.