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 [dentro, fora]
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.
Valor de retorno
CreateCryptoSession retorna um dos seguintes valores:
| Código de retorno | descrição |
|---|---|
| S_OK | A sessão de criptografia é 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. |
Observações
Se o DecodeProfile membro da estrutura de D3DDDIARG_CREATECRYPTOSESSION for NULL_GUID, a sessão de criptografia não será usada para decodificação do DirectX VA (DirectX Video Acceleration). Se DecodeProfile não for GUID de 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 hCryptoSession membro do 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 deve 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 |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 7. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |