PFND3DDDI_CREATECRYPTOSESSION función de devolución de llamada (d3dumddi.h)
La función CreateCryptoSession crea una sesión criptográfica que el entorno de ejecución de Direct3D usa para administrar una clave de sesión y para realizar operaciones criptográficas en y fuera de la memoria protegida.
Sintaxis
PFND3DDDI_CREATECRYPTOSESSION Pfnd3dddiCreatecryptosession;
HRESULT Pfnd3dddiCreatecryptosession(
HANDLE hDevice,
D3DDDIARG_CREATECRYPTOSESSION *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
pData [in, out]
Puntero a una estructura de D3DDDIARG_CREATECRYPTOSESSION . En la entrada, esta estructura contiene información que el controlador puede usar. En la salida, el controlador especifica información en la estructura que puede usar el entorno de ejecución de Microsoft Direct3D.
Valor devuelto
CreateCryptoSession devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| S_OK | La sesión criptográfica se crea correctamente. |
| E_OUTOFMEMORY | CreateCryptoSession no pudo asignar la memoria necesaria para que se complete. |
| D3DDDIERR_NOTAVAILABLE | El controlador no admite el GUID especificado en cryptoTypemember de la estructura D3DDDIARG_CREATECRYPTOSESSION o el NULL_GUID (todos los ceros) se especifica en CryptoTypemember. |
| D3DDDIERR_UNSUPPORTEDCRYPTO | El controlador no admite el tipo criptográfico para el tipo de descodificación especificado. |
Comentarios
Si el miembro DecodeProfile de la estructura de D3DDDIARG_CREATECRYPTOSESSION es NULL_GUID, la sesión criptográfica no se usará para la descodificación de DirectX Video Acceleration (DirectX VA). Si DecodeProfile no es GUID NULL , el controlador debe producir un error con D3DDDIERR_UNSUPPORTEDCRYPTO si el tipo criptográfico del miembro CryptoType no es compatible con el perfil de descodificación.
El controlador devuelve un identificador para la sesión criptográfica en el miembro hCryptoSession de D3DDDIARG_CREATECRYPTOSESSION que el tiempo de ejecución pasa en todas las llamadas de sesión criptográficas posteriores (por ejemplo, CryptoSessionKeyExchange).
El controlador debe realizar un seguimiento del dispositivo de visualización (hDevice) que se usó para crear la sesión criptográfica. El controlador debe producir un error en todas las llamadas posteriores que usen esta sesión criptográfica creada si el dispositivo de visualización especificado en esas llamadas es diferente del dispositivo de visualización que se usó para crear la sesión criptográfica.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 7. |
| Plataforma de destino | Escritorio |
| Encabezado | d3dumddi.h (incluya D3dumddi.h) |