DXGKDDI_OPM_GET_RANDOM_NUMBER Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

Die DxgkDdiOPMGetRandomNumber Funktion ruft die 128-Bit-Bit-Zufallszahl des 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 zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Zuvor stellte die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers dieses Handle für das DirectX-Grafik-Kernel-Subsystem bereit.

[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 128-Bit-Bit-Zufallszahl des geschützten Ausgabeobjekts empfängt, wenn DxgkDdiOPMGetRandom Number erfolgreich zurückgegeben wird.

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

Jedes geschützte Ausgabeobjekt muss über eine andere 128-Bit-kryptografisch sichere Zufallszahl verfügen, die ihr zugeordnet ist.

Rückgabewert

DxgkDdiOPMGetRandomNumber gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird eine der Fehlercodes zurückgegeben, die in Ntstatus.hdefiniert sind.

Bemerkungen

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 Angewendete Kryptografie, Second Edition.

DxgkDdiOPMGetRandomNumber sollte seitenfähig gemacht werden.