PFND3DDDI_CREATECRYPTOSESSION fonction de rappel (d3dumddi.h)

Article
08/07/2023

La fonction CreateCryptoSession crée une session de chiffrement que le runtime Direct3D utilise pour gérer une clé de session et effectuer des opérations de chiffrement dans et hors de la mémoire protégée.

Syntaxe

PFND3DDDI_CREATECRYPTOSESSION Pfnd3dddiCreatecryptosession;

HRESULT Pfnd3dddiCreatecryptosession(
  HANDLE hDevice,
  D3DDDIARG_CREATECRYPTOSESSION *unnamedParam2
)
{...}

Paramètres

hDevice

Handle de l’appareil d’affichage (contexte graphique).

unnamedParam2

pData [in, out]

Pointeur vers une structure D3DDDIARG_CREATECRYPTOSESSION . En entrée, cette structure contient des informations que le pilote peut utiliser. À la sortie, le pilote spécifie des informations dans la structure que le runtime Microsoft Direct3D peut utiliser.

Valeur retournée

CreateCryptoSession retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	La session de chiffrement est créée avec succès.
E_OUTOFMEMORY	CreateCryptoSession n’a pas pu allouer la mémoire nécessaire pour qu’elle se termine.
D3DDDIERR_NOTAVAILABLE	Le pilote ne prend pas en charge le GUID spécifié dans le CryptoTypemember de la structure D3DDDIARG_CREATECRYPTOSESSION ou le NULL_GUID (tous les zéros) est spécifié dans le CryptoTypemember.
D3DDDIERR_UNSUPPORTEDCRYPTO	Le pilote ne prend pas en charge le type de chiffrement pour le type de décodage spécifié.

Remarques

Si le membre DecodeProfile de la structure D3DDDIARG_CREATECRYPTOSESSION est NULL_GUID, la session de chiffrement ne sera pas utilisée pour le décodage directX Video Acceleration (DirectX VA). Si DecodeProfile n’est pas UN GUID NULL , le pilote doit échouer avec D3DDDIERR_UNSUPPORTEDCRYPTO si le type de chiffrement dans le membre CryptoType n’est pas pris en charge par le profil de décodage.

Le pilote retourne un handle pour la session de chiffrement dans le membre hCryptoSession de D3DDDIARG_CREATECRYPTOSESSION que le runtime passe dans tous les appels de session de chiffrement suivants (par exemple, CryptoSessionKeyExchange).

Le pilote doit suivre le périphérique d’affichage (hDevice) qui a été utilisé pour créer la session de chiffrement. Le pilote doit échouer tous les appels suivants qui utilisent cette session de chiffrement créée si le périphérique d’affichage spécifié dans ces appels est différent de l’appareil d’affichage utilisé pour créer la session de chiffrement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 7.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dumddi.h (inclure D3dumddi.h)

Voir aussi

CryptoSessionKeyExchange

D3DDDIARG_CREATECRYPTOSESSION

Partager via