struttura D3DHAL_DP2SETSTREAMSOURCE (d3dhal.h)

Solo DirectX 8.0 e versioni successive.

La struttura D3DHAL_DP2SETSTREAMSOURCE viene usata per associare un'origine del flusso dei vertici a un buffer dei vertici per D3dDrawPrimitives2.

Sintassi

typedef struct _D3DHAL_DP2SETSTREAMSOURCE {
  DWORD dwStream;
  DWORD dwVBHandle;
  DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCE;

Members

dwStream

Specifica il flusso associato. Ha un valore compreso tra zero e il numero massimo di flussi specificati dal driver.

dwVBHandle

Specifica l'handle del buffer dei vertici. È legale che l'handle del buffer dei vertici sia zero, nel qual caso il flusso non è più associato a un buffer dei vertici.

dwStride

Specifica le dimensioni dei vertici in byte.

Commenti

Un driver riceve una notifica dell'associazione di un buffer dei vertici a un determinato flusso tramite un nuovo token DP2, D3DDP2OP_SETSTREAMSOURCE.

Il runtime di debug verifica che dwStream sia compreso nell'intervallo legale, ma la versione definitiva non lo fa, quindi la convalida deve essere presente nel driver. DirectX 8.0 non definisce il comportamento del driver o dell'hardware nel caso di errore in cui l'indice di flusso specificato è maggiore del flusso massimo supportato dall'hardware (come indicato tramite MaxStreams in D3DCAPS8) oltre a richiedere che la combinazione di driver e hardware non sia difettosa o si blocchi in questo caso e che, in caso di ripristino dello stato corretto, la combinazione di driver e hardware deve continuare a funzionare normalmente. Le versioni di debug del driver di visualizzazione devono visualizzare i messaggi nel flusso di output di debug che indica quando è stato rilevato questo problema.

Il runtime non convalida che i flussi a cui accede il vertex shader corrente non siano NULL. È responsabilità del writer del driver assicurarsi che il driver/hardware non si arresti in modo anomalo quando si verifica questo caso di errore. Le versioni di debug del driver di visualizzazione devono visualizzare i messaggi nel flusso di output di debug per indicare quando è stato rilevato questo problema.

Solo un'origine flusso singola viene impostata da una struttura D3DHAL_DP2COMMAND . Ovvero, il campo wStateCount del D3DHAL_DP2COMMAND è sempre uno quando bCommand è D3DDP2OP_SETSTREAMSOURCE.

Requisiti

Requisito	Valore
Intestazione	d3dhal.h (include D3dhal.h)

Vedi anche

D3DDP2OP_SETSTREAMSOURCE

D3DHAL_DP2COMMAND

D3DHAL_DP2SETSTREAMSOURCEUM

D3dDrawPrimitives2