struttura D3DHAL_DP2SETSTREAMSOURCEUM (d3dhal.h)

Articolo
02/23/2024

Solo DirectX 8.0 e versioni successive.

La struttura D3DHAL_DP2SETSTREAMSOURCEUM viene usata per associare un'origine del flusso dei vertici a un buffer di memoria utente per D3dDrawPrimitives2.

Sintassi

typedef struct _D3DHAL_DP2SETSTREAMSOURCEUM {
  DWORD dwStream;
  DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCEUM;

Members

dwStream

Specifica il flusso associato. Per DirectX 8.0 è sempre zero.

dwStride

Specifica le dimensioni dei vertici in byte.

Commenti

Oltre ad eseguire il binding di un flusso a un vertex buffer, è possibile che i dati dei vertici del flusso zero vengano forniti in un buffer di memoria utente (UM). In questo caso, viene usato un altro token DP2 per notificare al driver di associazione di flusso. Tale token è D3DDP2OP_SETSTREAMSOURCEUM.

DirectX 8.0 non supporta più flussi di vertici con buffer forniti dall'utente anziché buffer dei vertici. Inoltre, non è possibile combinare buffer di memoria utente con i vertex buffer. Quando viene fornito un buffer di memoria utente, è garantito che sia zero e che sia l'unico flusso a cui accedere tramite primitive di disegno successive. È possibile che altri flussi dispongano di buffer dei vertici non NULL associati a tali buffer al momento in cui un buffer di memoria utente è associato al flusso. Tuttavia, questi altri flussi devono essere ignorati dal driver e dall'hardware.

Il puntatore di memoria utente effettivo ai dati dei vertici deve essere estratto dal D3DHAL_DRAWPRIMITIVES2DATA passato quando disegna effettivamente primitive.