DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT回调函数 (dispmprt.h)

项目
02/26/2024

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