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