Share via

Metodo ID3D10Device::SOSetTargets (d3d10.h)

  • Articolo

Impostare i buffer di output di destinazione per la fase StreamOutput , che abilita/disabilita la pipeline per trasmettere i dati.

Sintassi

void SOSetTargets(
  [in] UINT         NumBuffers,
  [in] ID3D10Buffer * const *ppSOTargets,
  [in] const UINT   *pOffsets
);

Parametri

[in] NumBuffers

Tipo: UINT

Numero di buffer da associare al dispositivo. È possibile impostare un massimo di quattro buffer di output. Se meno di quattro sono definiti dalla chiamata, gli slot del buffer rimanenti vengono impostati su NULL. Vedere la sezione Osservazioni.

[in] ppSOTargets

Tipo: ID3D10Buffer*

Matrice di buffer di output (vedere ID3D10Buffer) da associare al dispositivo. I buffer devono essere stati creati con il flag di D3D10_BIND_STREAM_OUTPUT .

[in] pOffsets

Tipo: const UINT*

Matrice di offset nei buffer di output da ppSOTargets, un offset per ogni buffer. I valori di offset devono essere in byte.

Valore restituito

nessuno

Osservazioni

Chiamare ID3D10Device::SOSetTargets (prima delle chiamate di disegno) per trasmettere i dati in uscita; chiamare SOSetTargets con NULL per arrestare l'uscita dei dati di streaming. Per un esempio, vedere Esercizio 01 dal workshop GDC 2007, che imposta il rendering dell'output del flusso prima di chiamare i metodi di disegno nella funzione RenderInstanceToStream.

Un offset di -1 causerà l'aggiunta del buffer di output del flusso, continuando dopo l'ultima posizione scritta nel buffer in un passaggio di output di flusso precedente.

La chiamata a questo metodo tramite un buffer attualmente associato per la scrittura associa invece NULL perché un buffer non può essere associato sia come input che come output contemporaneamente.

Il livello di debug genererà un avviso ogni volta che una risorsa non viene associata simultaneamente come input e un output, ma non impedirà l'uso di dati non validi dal runtime.

Il metodo non contiene un riferimento alle interfacce passate. Per questo motivo, le applicazioni devono prestare attenzione a non rilasciare un'interfaccia attualmente in uso dal dispositivo.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione d3d10.h
Libreria D3D10.lib

Vedi anche

Interfaccia ID3D10Device