PFND3DDDI_CREATECRYPTOSESSION função de retorno de chamada (d3dumddi.h)
A função CreateCryptoSession cria uma sessão de criptografia que o runtime do Direct3D usa para gerenciar uma chave de sessão e executar operações de criptografia dentro e fora da memória protegida.
Sintaxe
PFND3DDDI_CREATECRYPTOSESSION Pfnd3dddiCreatecryptosession;
HRESULT Pfnd3dddiCreatecryptosession(
HANDLE hDevice,
D3DDDIARG_CREATECRYPTOSESSION *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
pData [in, out]
Um ponteiro para uma estrutura D3DDDIARG_CREATECRYPTOSESSION . Na entrada, essa estrutura contém informações que o driver pode usar. Na saída, o driver especifica informações na estrutura que o runtime do Microsoft Direct3D pode usar.
Retornar valor
CreateCryptoSession retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | A sessão de criptografia foi criada com êxito. |
| E_OUTOFMEMORY | CreateCryptoSession não pôde alocar a memória necessária para que ela fosse concluída. |
| D3DDDIERR_NOTAVAILABLE | O driver não dá suporte ao GUID especificado no CryptoTypemember da estrutura D3DDDIARG_CREATECRYPTOSESSION ou o NULL_GUID (todos os zeros) é especificado no CryptoTypemember. |
| D3DDDIERR_UNSUPPORTEDCRYPTO | O driver não dá suporte ao tipo de criptografia para o tipo de decodificação especificado. |
Comentários
Se o membro DecodeProfile da estrutura D3DDDIARG_CREATECRYPTOSESSION for NULL_GUID, a sessão de criptografia não será usada para decodificação do DirectX (DirectX VA). Se DecodeProfile não for GUID NULL , o driver deverá falhar com D3DDDIERR_UNSUPPORTEDCRYPTO se o tipo de criptografia no membro CryptoType não tiver suporte pelo perfil de decodificação.
O driver retorna um identificador para a sessão de criptografia no membro hCryptoSession de D3DDDIARG_CREATECRYPTOSESSION que o runtime passa em todas as chamadas de sessão de criptografia subsequentes (por exemplo, CryptoSessionKeyExchange).
O driver deve acompanhar o dispositivo de exibição (hDevice) que foi usado para criar a sessão de criptografia. O driver deverá falhar em todas as chamadas subsequentes que usam essa sessão de criptografia criada se o dispositivo de exibição especificado nessas chamadas for diferente do dispositivo de exibição que foi usado para criar a sessão de criptografia.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte a partir do Windows 7. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |