структура 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 (включая D3dhal.h)

См. также раздел

D3DDP2OP_SETSTREAMSOURCE

D3DHAL_DP2COMMAND

D3DHAL_DP2SETSTREAMSOURCEUM

D3dDrawPrimitives2