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

  • Статья

Задает аналоговую защиту от копирования для указанного целевого идентификатора. Это функционально эквивалентно DxgkDdiUpdateActiveVidPnPresentPath в предыдущих версиях WDDM, если изменяется только D3DKMDT_VIDPN_PRESENT_PATH_COPYPROTECTION.

Синтаксис

DXGKDDI_SETTARGETANALOGCOPYPROTECTION DxgkddiSettargetanalogcopyprotection;

NTSTATUS DxgkddiSettargetanalogcopyprotection(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SETTARGETANALOGCOPYPROTECTION pSetTargetAnalogCopyProtectionArg
)
{...}

Параметры

hAdapter

Идентифицирует адаптер.

pSetTargetAnalogCopyProtectionArg

Указатель на структуру DXGKARG_SETTARGETANALOGCOPYPROTECTION, которая предоставляет целевой идентификатор и запрашиваемые параметры защиты аналогового содержимого.

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

Если эта подпрограмма завершается успешно, она возвращает STATUS_SUCCESS.

Комментарии

Это необязательный DDI, поэтому указатель функции в DRIVER_INITIALIZATION_DATA должен иметь значение NULL, если DDI реализован не для всех адаптеров, поддерживаемых драйвером. Так как защита аналогового содержимого поддерживается только в аналоговых целевых объектах и может не поддерживаться с помощью аппаратных ключей, со временем все более вероятно, что драйверам не потребуется поддерживать этот DDI.

Массив байтов OEMCopyProtection, который является частью структуры D3DKMDT_VIDPN_PRESENT_PATH_COPYPROTECTION, используемой в старом DDI, был удален, так как он был зарезервирован и никогда не определен, поэтому всегда содержал нули.

Эта функция всегда вызывается на уровне PASSIVE, поэтому вспомогательный код должен быть доступен для страниц.

Требования

Требование Значение
Целевая платформа Windows
Header d3dkmddi.h