DXGKDDI_OPM_GET_CERTIFICATE回调函数 (dispmprt.h)

  • 项目

DxgkDdiOPMGetCertificate 函数检索给定类型和大小的证书。

语法

DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;

NTSTATUS DxgkddiOpmGetCertificate(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [in]  ULONG CertificateSize,
  [out] PVOID CertificateBuffer
)
{...}

参数

[in] MiniportDeviceContext

与显示适配器关联的上下文块的句柄。 以前，显示微型端口驱动程序的 DxgkDdiAddDevice 函数为 DirectX 图形内核子系统提供了此句柄。

[in] CertificateType

一个DXGKMDT_CERTIFICATE_TYPE类型的值，用于标识要检索的证书类型。

[in] CertificateSize

要检索的证书的大小（以字节为单位）。 此大小是通过调用显示微型端口驱动程序的 DxgkDdiOPMGetCertificateSize 函数返回的。

[out] CertificateBuffer

指向一个缓冲区的指针，该缓冲区接收请求的证书（如果 DxgkDdiOPMGetCertificate 成功返回）。 如果 DxgkDdiOPMGetCertificate 失败，则缓冲区的内容将保持不变。

返回值

DxgkDdiOPMGetCertificate 返回以下值之一。

返回代码 说明
STATUS_SUCCESS 函数已成功检索证书大小。
STATUS_GRAPHICS_OPM_NOT_SUPPORTED 显示微型端口驱动程序不支持 OPM，因为硬件供应商从未签署 OPM 许可协议，或者微型端口驱动程序的图形硬件不符合 OPM 规则。 如果显示微型端口驱动程序检测到篡改，DxgkDdiOPMGetCertificate 也可以返回此值。
STATUS_GRAPHICS_COPP_NOT_SUPPORTED 显示微型端口驱动程序不支持 COPP，因为硬件供应商从未签署过 COPP 许可协议，或者微型端口驱动程序的图形硬件不符合 COPP 规则。 如果显示微型端口驱动程序检测到篡改，DxgkDdiOPMGetCertificate 也可以返回此值。
STATUS_GRAPHICS_UAB_NOT_SUPPORTED 显示微型端口驱动程序不支持 UAB，因为硬件供应商从未签署过 UAB 许可协议，或者微型端口驱动程序的图形硬件不符合 UAB 规则。 如果显示微型端口驱动程序检测到篡改，DxgkDdiOPMGetCertificate 也可以返回此值。
STATUS_GRAPHICS_PVP_HFS_FAILED 显示微型端口驱动程序的硬件功能扫描 (HFS) 失败或显示微型端口驱动程序检测到篡改。 显示微型端口驱动程序可以选择性地返回此值。 如果 DxgkDdiOPMGetCertificate 不返回此值进行篡改，则它可以返回以前的错误代码之一。

此函数还可能返回 Ntstatus.h 中定义的其他错误代码。

注解

DxgkDdiOPMGetCertificate 可以检索显示微型端口驱动程序的 OPM 证书、用户可访问总线 (UAB) 证书或认证输出保护协议 (COPP) 证书。 有关这些证书的信息，请下载 输出内容保护和 Windows Vista 文档。

应使 DxgkDdiOPMGetCertificate 可分页。

要求

要求 值
目标平台 桌面
标头 dispmprt.h (包括 Dispmprt.h)
IRQL PASSIVE_LEVEL (请参阅备注部分)

另请参阅

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

DxgkDdiOPMGetCertificateSize