DXGKDDI_OPM_GET_CERTIFICATE_SIZE回调函数 (dispmprt.h)

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

语法

DXGKDDI_OPM_GET_CERTIFICATE_SIZE DxgkddiOpmGetCertificateSize;

NTSTATUS DxgkddiOpmGetCertificateSize(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [out] PULONG CertificateSize
)
{...}

参数

[in] MiniportDeviceContext

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

[in] CertificateType

一个DXGKMDT_CERTIFICATE_TYPE类型的值，用于标识其大小 DxgkDdiOPMGetCertificateSize 返回的证书类型。

[out] CertificateSize

指向一个变量的指针，该变量接收证书的大小（以字节为单位），该证书的类型由 CertificateType 参数中的 值标识。

返回值

DxgkDdiOPMGetCertificateSize 返回以下值之一：

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

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

注解

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

DxgkDdiOPMGetCertificateSize 应设为可分页。

要求

要求	值
最低受支持的客户端	Windows 8
最低受支持的服务器	Windows Server 2012
目标平台	桌面
标头	dispmprt.h (包括 Dispmprt.h)
IRQL	PASSIVE_LEVEL (请参阅备注部分)

另请参阅

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice