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

  • Статья

SetHardwareProtection позволяет полноэкранным буферам цепочки буферов буферов диспетчера окон рабочего стола (DWM) передавать между защищенными и незащищенными состояниями без необходимости повторного создания.

Синтаксис

PFND3DWDDM2_0DDI_SETHARDWAREPROTECTION Pfnd3dwddm20DdiSethardwareprotection;

void Pfnd3dwddm20DdiSethardwareprotection(
  D3D10DDI_HDEVICE hDevice,
  D3D10DDI_HRESOURCE hResource,
  BOOL Protected
)
{...}

Параметры

hDevice

Дескриптор устройства отображения (графический контекст). Среда выполнения Direct3D передала драйвер пользовательского режима этот дескриптор в качестве члена hDeviceструктуры D3DDDIARG_CREATEDEVICE при создании устройства.

hResource

Дескриптор объекта ресурса, созданного с помощью вызова CreateResourceDDI.

Protected

Указывает, что буфер должен быть защищен.

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

None

Remarks

Уничтожение и повторное создание буферов цепочки буферов DWM — это тяжелая операция, которую можно избежать на некотором оборудовании. Этот DDI будет вызываться только в том случае, если драйвер сообщает о возможности D3DWDDM2_0DDI_CONTENT_PROTECTION_CAPS_HARDWARE_PROTECTED_MEMORY_TRANSITION . Если этот параметр не задан, базовые выделения цепочки буферов DWM будут уничтожены и повторно созданы.

Метод SetHardwareProtection вызывается в невидимых буферах цепочки буферов, что позволяет переходить между защищенным и незащищенным режимами без создания визуального артефакта. При переключении DWM на только что измененный буфер DWM вызывает SetHardwareProtection для следующего буфера в буфере цепочки буферов и т. д., пока не будет установлено новое состояние защиты для каждого из буферов цепочки буферов.

Примечание DwM гарантированно повторно отрисовывает весь буфер цепочки буферов после изменения состояния защиты оборудования.
 

Требования

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

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

CreateResource

D3DDDIARG_CREATEDEVICE