PFND3DDDI_CREATECRYPTOSESSION funzione di callback (d3dumddi.h)
La funzione CreateCryptoSession crea una sessione di crittografia usata dal runtime Direct3D per gestire una chiave di sessione e per eseguire operazioni di crittografia in e fuori memoria protetta.
Sintassi
PFND3DDDI_CREATECRYPTOSESSION Pfnd3dddiCreatecryptosession;
HRESULT Pfnd3dddiCreatecryptosession(
HANDLE hDevice,
D3DDDIARG_CREATECRYPTOSESSION *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in, out]
Puntatore a una struttura D3DDDIARG_CREATECRYPTOSESSION . In input, questa struttura contiene informazioni che il driver può usare. Nell'output, il driver specifica le informazioni nella struttura che il runtime di Microsoft Direct3D può usare.
Valore restituito
CreateCryptoSession restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| S_OK | La sessione di crittografia viene creata correttamente. |
| E_OUTOFMEMORY | CreateCryptoSession non è riuscito ad allocare la memoria necessaria per il completamento. |
| D3DDDIERR_NOTAVAILABLE | Il driver non supporta il GUID specificato nel componente CryptoTypemember della struttura D3DDDIARG_CREATECRYPTOSESSION o il NULL_GUID (tutti gli zeri) viene specificato in CryptoTypemember. |
| D3DDDIERR_UNSUPPORTEDCRYPTO | Il driver non supporta il tipo di crittografia per il tipo di decodifica specificato. |
Commenti
Se il membro DecodeProfile della struttura D3DDDIARG_CREATECRYPTOSESSION è NULL_GUID, la sessione di crittografia non verrà usata per la decodifica DirectX Video Acceleration (DirectX VA). Se DecodeProfile non è NULL GUID, il driver deve avere esito negativo con D3DDDIERR_UNSUPPORTEDCRYPTO se il tipo di crittografia nel membro CryptoType non è supportato dal profilo di decodifica.
Il driver restituisce un handle per la sessione di crittografia nel membro hCryptoSession di D3DDDIARG_CREATECRYPTOSESSION che il runtime passa in tutte le successive chiamate di sessione di crittografia (ad esempio , CryptoSessionKeyExchange).
Il driver deve tenere traccia del dispositivo di visualizzazione (hDevice) usato per creare la sessione di crittografia. Il driver deve non riuscire tutte le chiamate successive che usano questa sessione di crittografia creata se il dispositivo di visualizzazione specificato in tali chiamate è diverso dal dispositivo di visualizzazione usato per creare la sessione di crittografia.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 7. |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dumddi.h (include D3dumddi.h) |