структура D3DHAL_DP2SETSTREAMSOURCE (d3dhal.h)
Только версии DirectX 8.0 и более поздних версий.
Структура D3DHAL_DP2SETSTREAMSOURCE используется для привязки источника потока вершин к буферу вершин для D3dDrawPrimitives2.
Синтаксис
typedef struct _D3DHAL_DP2SETSTREAMSOURCE {
DWORD dwStream;
DWORD dwVBHandle;
DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCE;
Члены
dwStream
Указывает ограничивающий поток. Он имеет значение от нуля до максимального количества потоков, указанных драйвером.
dwVBHandle
Указывает дескриптор буфера вершин. Это законно для дескриптора вершинного буфера равно нулю, в этом случае поток больше не привязан к буферу вершин.
dwStride
Указывает размер вершины в байтах.
Замечания
Драйвер уведомляется о привязке буфера вершин к определенному потоку через новый токен DP2 D3DDP2OP_SETSTREAMSOURCE.
Среда выполнения отладки проверяет, что dwStream находится в юридическом диапазоне, но в розничной версии нет, поэтому проверка должна присутствовать в драйвере. DirectX 8.0 не определяет поведение драйвера или оборудования в случае ошибки, когда заданный индекс потока превышает максимальный поток, поддерживаемый оборудованием (как сообщается с помощью MaxStreams в D3DCAPS8) за пределами необходимости, чтобы сочетание драйверов и оборудования не сбой или зависание в данном случае, и что, при восстановлении правильного состояния драйвер и аппаратное сочетание должны продолжать работать нормально. Отладочные версии драйвера отображения должны отображать сообщения в потоке вывода отладки, указывающие, когда обнаружена эта проблема.
Среда выполнения не проверяет, что потоки, к которым обращается текущий шейдер вершин, не имеют значения NULL. Это ответственность за запись драйвера, чтобы убедиться, что драйвер или оборудование не завершает работу при возникновении этого случая ошибки. Отладочные версии драйвера отображения должны отображать сообщения в потоке выходных данных отладки, чтобы указать, когда обнаружена эта проблема.
Только один источник потока задается структурой D3DHAL_DP2COMMAND. То есть поле wStateCount D3DHAL_DP2COMMAND всегда является одним, если bCommand D3DDP2OP_SETSTREAMSOURCE.
Требования
| Требование | Ценность |
|---|---|
| заголовка | d3dhal.h (include D3dhal.h) |
См. также
D3DDP2OP_SETSTREAMSOURCE