PFND3DDDI_CREATECRYPTOSESSION fonction de rappel (d3dumddi.h)
La fonction CreateCryptoSession crée une session de chiffrement utilisée par le runtime Direct3D 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. Lors de l’entrée, cette structure contient des informations que le pilote peut utiliser. En sortie, le pilote spécifie des informations dans la structure que le runtime Microsoft Direct3D peut utiliser.
Valeur de retour
CreateCryptoSession retourne l’une des valeurs suivantes :
| code de retour | Description |
|---|---|
| S_OK | La session de chiffrement a été créée avec succès. |
| E_OUTOFMEMORY | CreateCryptoSession n’a pas pu allouer la mémoire requise pour qu’elle se termine. |
| D3DDDIERR_NOTAVAILABLE | Le pilote ne prend pas en charge le GUID spécifié dans le fichier 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 DecodeProfile membre 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 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) 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 l’appareil d’affichage spécifié dans ces appels est différent de l’appareil d’affichage utilisé pour créer la session de chiffrement.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 7. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |