DXGKDDI_OPM_GET_RANDOM_NUMBER funzione di callback (dispmprt.h)
La funzione DxgkDdiOPMGetRandomNumber recupera il numero casuale a 128 bit 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 per un blocco di contesto associato a una scheda di visualizzazione. In precedenza, la funzione dxgkDdiAddDevice del driver miniport di visualizzazione forniva questo handle al sottosistema del kernel grafico DirectX.
[in] ProtectedOutputHandle
Handle di un oggetto di output protetto. La funzione DxgkDdiOPMCreateProtectedOutput crea l'oggetto di output protetto e restituisce l'handle all'oggetto .
[out] RandomNumber
Puntatore a una struttura DXGKMDT_OPM_RANDOM_NUMBER che riceve il numero casuale a 128 bit dell'oggetto di output protetto se DxgkDdiOPMGetRandomNumber restituisce correttamente.
Se DxgkDdiOPMGetRandomNumber ha esito negativo, il valore a cui RandomNumber punta è invariato.
A ogni oggetto di output protetto deve essere associato un numero casuale a 128 bit diverso.
Valore restituito
DxgkDdiOPMGetRandomNumber restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Osservazioni
DxgkDdiOPMGetRandomNumber viene chiamato una sola volta per ogni output protetto e non viene mai chiamato dopo la chiamata al DxgkDdiOPMSetSigningKeyAndSequenceNumbers funzione.
Per altre informazioni sui numeri casuali sicuri in modo crittografico, vedere la sezione 2.8 in Crittografia applicata, seconda edizione.
dxgkDdiOPMGetRandomNumber deve essere reso pageable.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (vedere la sezione Osservazioni) |