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

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 ( _
    device As Device, _
    sizeOfBufferInBytes As Integer, _
    usage As Usage, _
    pool As Pool, _
    sixteenBitIndices As Boolean _
)
'Utilizzo
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
)

Parametri

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

Oggetto Device da associare al buffer indice.

sizeOfBufferInBytes
Tipo: System.Int32

Dimensioni in byte del 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.

sixteenBitIndices
Tipo: System.Boolean

Impostare su true se il buffer indice contiene indici a 16 bit. Impostare su false se il buffer indice contiene indici a 32 bit.

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:

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.