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

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 设为可分页。