DXGKDDI_OPM_GET_RANDOM_NUMBER fonction de rappel (dispmprt.h)

Article
02/06/2025

La fonction DxgkDdiOPMGetRandomNumber récupère le nombre aléatoire sécurisé de 128 bits de l’objet de sortie protégé donné.

Syntaxe

DXGKDDI_OPM_GET_RANDOM_NUMBER DxgkddiOpmGetRandomNumber;

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

Paramètres

[in] MiniportDeviceContext

Handle vers un bloc de contexte associé à un adaptateur d’affichage. Auparavant, la fonction d’affichage du pilote miniport DxgkDdiAddDevice fournissait ce handle au sous-système du noyau graphique DirectX.

[in] ProtectedOutputHandle

Handle vers un objet de sortie protégé. La fonction DxgkDdiOPMCreateProtectedOutput crée l’objet de sortie protégé et retourne le handle à l’objet.

[out] RandomNumber

Pointeur vers une structure DXGKMDT_OPM_RANDOM_NUMBER qui reçoit le nombre aléatoire sécurisé par chiffrement 128 bits de l’objet de sortie protégé si DxgkDdiOPMGetRandomNumber retourne correctement.

Si DxgkDdiOPMGetRandomNumber échoue, la valeur à laquelle RandomNumber points est inchangée.

Chaque objet de sortie protégé doit avoir un nombre aléatoire sécurisé de 128 bits différent associé à celui-ci.

Valeur de retour

DxgkDdiOPMGetRandomNumber retourne STATUS_SUCCESS si elle réussit. Sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

DxgkDdiOPMGetRandomNumber est appelé une seule fois pour chaque sortie protégée et n’est jamais appelé après l’appel à la fonction DxgkDdiOPMSetSigningKeyAndSequenceNumbers se produit.

Pour plus d’informations sur les nombres aléatoires sécurisés par chiffrement, consultez la section 2.8 dans de chiffrement appliqué, Deuxième édition.

DxgkDdiOPMGetRandomNumber doit être rendu paginable.