DXGKDDI_OPM_GET_RANDOM_NUMBER Rückruffunktion (dispmprt.h)

Artikel
02/23/2024

Die DxgkDdiOPMGetRandomNumber-Funktion ruft die kryptografisch sichere 128-Bit-Zufallszahl des angegebenen geschützten Ausgabeobjekts ab.

Syntax

DXGKDDI_OPM_GET_RANDOM_NUMBER DxgkddiOpmGetRandomNumber;

NTSTATUS DxgkddiOpmGetRandomNumber(
  [in]  PVOID MiniportDeviceContext,
  [in]  HANDLE ProtectedOutputHandle,
  [out] PDXGKMDT_OPM_RANDOM_NUMBER RandomNumber
)
{...}

Parameter

[in] MiniportDeviceContext

Ein Handle für einen Kontextblock, der einem Grafikkarte zugeordnet ist. Zuvor hat die DxgkDdiAddDevice-Funktion des Anzeigeminiporttreibers dieses Handle für das DirectX-Grafikkernsubsystem bereitgestellt.

[in] ProtectedOutputHandle

Das Handle für ein geschütztes Ausgabeobjekt. Die DxgkDdiOPMCreateProtectedOutput-Funktion erstellt das geschützte Ausgabeobjekt und gibt das Handle an das Objekt zurück.

[out] RandomNumber

Ein Zeiger auf eine DXGKMDT_OPM_RANDOM_NUMBER Struktur, die die kryptografisch sichere 128-Bit-Zufallszahl des geschützten Ausgabeobjekts empfängt, wenn DxgkDdiOPMGetRandomNumber erfolgreich zurückgibt.

Wenn DxgkDdiOPMGetRandomNumber fehlschlägt, bleibt der Wert, auf den RandomNumber verweist, unverändert.

Jedem geschützten Ausgabeobjekt muss eine andere kryptografisch sichere 128-Bit-Zufallszahl zugeordnet sein.

Rückgabewert

DxgkDdiOPMGetRandomNumber gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der Fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.

Hinweise

DxgkDdiOPMGetRandomNumber wird nur einmal für jede geschützte Ausgabe aufgerufen und wird nie aufgerufen, nachdem der Aufruf der DxgkDdiOPMSetSigningKeyAndSequenceNumbers-Funktion erfolgt.

Weitere Informationen zu kryptografisch sicheren Zufallszahlen finden Sie in Abschnitt 2.8 in Applied Cryptography, Second Edition.

DxgkDdiOPMGetRandomNumber sollte seitenfähig gemacht werden.