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;
Membri
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.
Osservazioni
Un driver riceve una notifica dell'associazione di un vertex buffer a un determinato flusso tramite un nuovo token DP2, D3DDP2OP_SETSTREAMSOURCE.
Il runtime di debug convalida che dwStream si trova all'interno dell'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 di flusso singola viene impostata da una struttura D3DHAL_DP2COMMAND. Ovvero, il campo wStateCount del D3DHAL_DP2COMMAND è sempre uno quando bCommand è D3DDP2OP_SETSTREAMSOURCE.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | d3dhal.h (include D3dhal.h) |
Vedere anche
D3DDP2OP_SETSTREAMSOURCE