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

另请参阅

DXGKMDT_OPM_RANDOM_NUMBER

DxgkDdiAddDevice

DxgkDdiOPMCreateProtectedOutput

DxgkDdiOPMSetSigningKeyAndSequenceNumbers