DXGKDDI_OPM_GET_RANDOM_NUMBER funzione di callback (dispmprt.h)

Articolo
02/25/2024

La funzione DxgkDdiOPMGetRandomNumber recupera il numero casuale casuale dell'oggetto di output protetto specificato.

Sintassi

DXGKDDI_OPM_GET_RANDOM_NUMBER DxgkddiOpmGetRandomNumber;

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

Parametri

[in] MiniportDeviceContext

Handle a un blocco di contesto associato a una scheda di visualizzazione. In precedenza, la funzione DxgkDdiAddDevice del driver del miniport visualizzato ha fornito questo handle al sottosistema del kernel grafico DirectX.

[in] ProtectedOutputHandle

Handle in un oggetto di output protetto. La funzione DxgkDdiOPMCreateProtectedOutput crea l'oggetto output protetto e restituisce l'handle all'oggetto .

[out] RandomNumber

Puntatore a una struttura DXGKMDT_OPM_RANDOM_NUMBER che riceve correttamente il numero casuale a 128 bit dell'oggetto di output protetto da DxgkDdiOPMGetRandomNumber .

Se DxgkDdiOPMGetRandomNumber ha esito negativo, il valore a cui punta RandomNumber è invariato.

Ogni oggetto di output protetto deve avere un numero casuale a 128 bit diverso associato a esso.

Valore restituito

DxgkDdiOPMGetRandomNumber restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

DxgkDdiOPMGetRandomNumber viene chiamato una sola volta per ogni output protetto e non viene mai chiamato dopo la chiamata alla funzione DxgkDdiOPMSetSigningKeyAndSequenceNumbers .

Per altre informazioni sui numeri casuali sicuri in modo crittografico, vedere la sezione 2.8 in Crittografia applicata, Seconda edizione.

DxgkDdiOPMGetRandomNumber deve essere reso paginabile.