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

Статья
08/07/2023

Отправляет невыполненные аппаратные команды, которые находятся в буфере команд оборудования, в драйвер мини-порта дисплея. Реализовано драйверами windows Display Driver Model (WDDM) 1.2 и более поздних версий в пользовательском режиме.

Синтаксис

PFND3D11_1DDI_FLUSH Pfnd3d111DdiFlush;

BOOL Pfnd3d111DdiFlush(
  D3D10DDI_HDEVICE unnamedParam1,
  UINT FlushFlags
)
{...}

Параметры

unnamedParam1

hDevice [in]

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

FlushFlags

Значение из перечисления D3D11_1_DDI_FLUSH_FLAGS , указывающее, должен ли драйвер продолжать отправлять буферы команд, если новых команд не было.

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

Возвращает значение TRUE , если аппаратные команды были успешно удалены. В противном случае возвращает значение FALSE.

Remarks

После завершения функции Flush(D3D11_1) все ранее выполненные команды больше не зависят от действий, выполняемых в контексте пользовательского режима приложения. Кроме того, приложения могут безопасно приостановить работу, не блокируя отрисовку, пока ядро не перезапустит их (например, при использовании асинхронного запроса).

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

Требования

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

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

D3D10_1DDI_DEVICEFUNCS

D3D11_1_DDI_FLUSH_FLAGS

pfnSetErrorCb