Condividi tramite

PFND3DDDI_CREATECRYPTOSESSION funzione di callback (d3dumddi.h)

  • Articolo

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)

Vedi anche

CryptoSessionKeyExchange

D3DDDIARG_CREATECRYPTOSESSION