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

Статья
02/06/2025

Функция 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

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

[in] AdditionalParameters

Указатель на буфер, содержащий дополнительные параметры, используемые для настройки защищенного выходного объекта, дескриптор которого указан в параметре ProtectedOutputHandle. Для эмуляции COPP это значение NULL. Если для параметра AdditionalParametersSize задано значение 0, Значение "Дополнительныеparameters" всегда имеет значение 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 (include Dispmprt.h)
IRQL	PASSIVE_LEVEL (см. раздел "Примечания")

См. также

DxgkDdiOPMGetCOPPCompatibleInformation

DxgkDdiOPMCreateProtectedOutput

DxgkDdiAddDevice

DXGKMDT_OPM_CONFIGURE_PARAMETERS

DxgkDdiOPMGetInformation

Поделиться через