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

Статья
08/07/2023

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

Синтаксис

PFND3D11DDI_CREATECOMMANDLIST Pfnd3d11ddiCreatecommandlist;

void Pfnd3d11ddiCreatecommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11DDIARG_CREATECOMMANDLIST *unnamedParam2,
  D3D11DDI_HCOMMANDLIST unnamedParam3,
  D3D11DDI_HRTCOMMANDLIST unnamedParam4
)
{...}

Параметры

unnamedParam1

hDevice [in]

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

unnamedParam2

pCreateCommandList [in]

Указатель на структуру D3D11DDIARG_CREATECOMMANDLIST , описывающую параметры, которые драйвер отображения пользовательского режима использует для создания списка команд.

unnamedParam3

hCommandList [in]

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

unnamedParam4

hRTCommandList [вход]

Дескриптор списка команд, который должен использовать драйвер при обратном вызове в среду выполнения Direct3D.

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

None

Remarks

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

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

Драйвер может передать E_OUTOFMEMORY (если у драйвера заканчивается память) или D3DDDIERR_DEVICEREMOVED (если устройство удалено) в вызове функции pfnSetErrorCb . Среда выполнения Direct3D определяет, что любые другие ошибки являются критическими. Если драйвер передает ошибки, включая D3DDDIERR_DEVICEREMOVED, среда выполнения Direct3D определяет, что дескриптор недопустим; Поэтому среда выполнения не вызывает функцию DestroyCommandList для уничтожения дескриптора, указанного параметром hCommandList .

Требования

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