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 结构的指针，如果 DxgkDdiOPMGetRandomNumber 成功返回，则接收受保护输出对象的 128 位加密安全随机数。
如果 DxgkDdiOPMGetRandomNumber 失败，则 RandomNumber 指向的值保持不变。
每个受保护的输出对象必须具有不同的 128 位加密安全随机数，
返回值
DxgkDdiOPMGetRandomNumber 如果成功，则返回STATUS_SUCCESS。 否则，它将返回 Ntstatus.h中定义的错误代码之一。
言论
对于每个受保护的输出，DxgkDdiOPMGetRandomNumber 只调用一次，在调用 DxgkDdiOPMSetSigningKeyAndSequenceNumbers 函数后，永远不会调用它。
有关加密安全随机数的详细信息，请参阅 应用加密第二版中的第 2.8 节。
应 DxgkDdiOPMGetRandomNumber 进行分页。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dispmprt.h （包括 Dispmprt.h） |
| IRQL | PASSIVE_LEVEL（请参阅“备注”部分） |