DXGKDDI_OPM_GET_RANDOM_NUMBER回调函数 (dispmprt.h)
DxgkDdiOPMGetRandomNumber 函数检索给定受保护输出对象的 128 位加密安全随机数。
语法
DXGKDDI_OPM_GET_RANDOM_NUMBER DxgkddiOpmGetRandomNumber;
NTSTATUS DxgkddiOpmGetRandomNumber(
[in] PVOID MiniportDeviceContext,
[in] HANDLE ProtectedOutputHandle,
[out] PDXGKMDT_OPM_RANDOM_NUMBER RandomNumber
)
{...}
参数
[in] MiniportDeviceContext
与显示适配器关联的上下文块的句柄。 以前，显示微型端口驱动程序的 DxgkDdiAddDevice 函数为 DirectX 图形内核子系统提供了此句柄。
[in] ProtectedOutputHandle
受保护输出对象的句柄。 DxgkDdiOPMCreateProtectedOutput 函数创建受保护的输出对象，并将句柄返回到 对象。
[out] RandomNumber
指向 DXGKMDT_OPM_RANDOM_NUMBER 结构的指针，该结构接收受保护输出对象的 128 位加密安全随机数（如果 DxgkDdiOPMGetRandomNumber 成功返回）。
如果 DxgkDdiOPMGetRandomNumber 失败， RandomNumber 指向的值将保持不变。
每个受保护的输出对象必须具有与之关联的不同 128 位加密安全随机数。
返回值
DxgkDdiOPMGetRandomNumber 如果成功，则返回STATUS_SUCCESS。 否则，它将返回 Ntstatus.h 中定义的错误代码之一。
注解
DxgkDdiOPMGetRandomNumber 仅针对每个受保护输出调用一次，在调用 DxgkDdiOPMSetSigningKeyAndSequenceNumbers 函数后永远不会调用。
有关加密安全随机数的详细信息，请参阅 应用加密第二版中的第 2.8 节。
应使 DxgkDdiOPMGetRandomNumber 可分页。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dispmprt.h (包括 Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (请参阅备注部分) |