функция обратного вызова PFND3D11DDI_RECYCLECOMMANDLIST (d3d10umddi.h)

Статья
02/22/2024

Функция RecycleCommandList перезапускает список команд.

Синтаксис

PFND3D11DDI_RECYCLECOMMANDLIST Pfnd3d11ddiRecyclecommandlist;

void Pfnd3d11ddiRecyclecommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}

Параметры

unnamedParam1

hDevice [in]

Дескриптор устройства отображения (графический контекст).

unnamedParam2

hCommandList [in]

Немедленная обработка контекста для личных данных драйвера для перезапуска списка команд.

Возвращаемое значение

None

Remarks

Драйвер может использовать функцию обратного вызова pfnSetErrorCb , чтобы задать код ошибки.

Драйвер требуется для реализации RecycleCommandList только в том случае, если драйвер поддерживает D3D11DDICAPS_COMMANDLISTS_BUILD_2 бит возможностей потоков. Драйвер может возвращать D3D11DDICAPS_COMMANDLISTS_BUILD_2 в члене Caps структуры D3D11DDI_THREADING_CAPS из вызова функции GetCaps(D3D10_2) драйвера.

Дополнительные сведения о RecycleCommandList см. в разделе Оптимизация для небольших Списки команд.

Драйвер не должен столкнуться с какой-либо ошибкой, за исключением D3DDDIERR_DEVICEREMOVED. Таким образом, если драйвер передает любую ошибку, за исключением D3DDDIERR_DEVICEREMOVED, в вызове функции pfnSetErrorCb , среда выполнения Direct3D определяет, что ошибка является критической. Даже если устройство удалено, драйвер не обязан возвращать D3DDDIERR_DEVICEREMOVED. Однако если удаление устройства мешает работе RecycleCommandList (что обычно не должно происходить), драйвер может вернуть D3DDDIERR_DEVICEREMOVED.

Требования

Требование	Значение
Минимальная версия клиента	RecycleCommandList поддерживается начиная с операционной системы Windows 7.
Целевая платформа	Персональный компьютер
Верхняя часть	d3d10umddi.h (включая D3d10umddi.h)

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

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps(D3D10_2)

pfnSetErrorCb

Поделиться через