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

  • Статья

Функция DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT настраивает заданный защищенный выходной объект.

Синтаксис

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT DxgkddiOpmConfigureProtectedOutput;

NTSTATUS DxgkddiOpmConfigureProtectedOutput(
  [in] PVOID MiniportDeviceContext,
  [in] HANDLE ProtectedOutputHandle,
  [in] const DXGKMDT_OPM_CONFIGURE_PARAMETERS *Parameters,
  [in] ULONG AdditionalParametersSize,
  [in] const VOID *AdditionalParameters
)
{...}

Параметры

[in] MiniportDeviceContext

Дескриптор для блока контекста, связанного с видеоадаптером. Функция DxgkDdiAddDevice драйвера мини-порта дисплея ранее предоставляла этот дескриптор подсистеме графического ядра DirectX.

[in] ProtectedOutputHandle

Дескриптор защищенного выходного объекта. Функция DxgkDdiOPMCreateProtectedOutput создает защищенный выходной объект и возвращает дескриптор объекту .

[in] Parameters

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

[in] AdditionalParametersSize

Размер (в байтах) дополнительных параметров в буфере, на который указывает AdditionalParameters. Для эмуляции сертифицированного протокола защиты вывода (COPP) это 0.

[in] AdditionalParameters

Указатель на буфер, содержащий дополнительные параметры, используемые для настройки защищенного выходного объекта, дескриптор которого указан в параметре ProtectedOutputHandle . Для эмуляции COPP это значение NULL. Если для параметра AdditionalParametersSize задано значение 0, параметру AdditionalParameters всегда присваивается значение NULL.

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

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT возвращает одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS Функция успешно настроила защищенный выходной объект.
STATUS_NO_MEMORY DxgkDdiOPMConfigureProtectedOutput не может выделить память, необходимую для ее завершения.

Эта функция также может возвращать другие коды ошибок, определенные в ntstatus.h.

Комментарии

Подсистема графического ядра DirectX вызывает DxgkDdiOPMGetInformation или DxgkDdiOPMGetCOPPCompatibleInformation для получения сведений о выходных данных, а затем вызывает DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT один или несколько раз для настройки выходных данных.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT должны быть доступны для страниц.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dispmprt.h (включая Dispmprt.h)
IRQL PASSIVE_LEVEL (см. раздел "Примечания")

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

DxgkDdiOPMGetCOPPCompatibleInformation

DxgkDdiOPMCreateProtectedOutput

DxgkDdiAddDevice

DXGKMDT_OPM_CONFIGURE_PARAMETERS

DxgkDdiOPMGetInformation