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 (请参阅备注部分) |