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 （請參閱一節） |