DXGKDDI_OPM_GET_RANDOM_NUMBER fonction de rappel (dispmprt.h)

Article
02/26/2024

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 d’un bloc de contexte associé à une carte d’affichage. Auparavant, la fonction DxgkDdiAddDevice du pilote miniport d’affichage fournissait cette poignée au sous-système du noyau graphique DirectX.

[in] ProtectedOutputHandle

Handle d’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 128 bits sécurisé par chiffrement de l’objet de sortie protégée si DxgkDdiOPMGetRandomNumber retourne correctement.

Si DxgkDdiOPMGetRandomNumber échoue, la valeur vers laquelle RandomNumber pointe est inchangée.

Chaque objet de sortie protégé doit avoir un nombre aléatoire 128 bits sécurisé par chiffrement différent qui lui est associé.

Valeur retournée

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

Remarques

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

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

DxgkDdiOPMGetRandomNumber doit être mis en page.