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
如果 DxgkDdiOPMGetRandomNumber 成功傳回，則為接收受保護輸出物件的 128 位密碼編譯安全隨機數之結構 DXGKMDT_OPM_RANDOM_NUMBER指標。
如果 DxgkDdiOPMGetRandomNumber 失敗， RandomNumber 所指向的值會保持不變。
每個受保護的輸出物件都必須有不同的 128 位密碼編譯安全隨機數與其相關聯。
傳回值
DxgkDdiOPMGetRandomNumber 會在成功時傳回STATUS_SUCCESS。 否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
備註
DxgkDdiOPMGetRandomNumber 只會針對每個受保護的輸出呼叫一次，而且永遠不會在呼叫 DxgkDdiOPMSetSigningKeyAndSequenceNumbers 函式之後呼叫。
如需密碼編譯安全隨機數的詳細資訊，請參閱 套用密碼編譯第二版中的第 2.8 節。
DxgkDdiOPMGetRandomNumber 應設為可分頁。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | dispmprt.h (包括 Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (请参阅一节) |