PFND3DDDI_GETENCRYPTIONBLTKEY função de retorno de chamada (d3dumddi.h)
A função GetEncryptionBltKey retorna a chave usada para descriptografar os dados que a função EncryptionBlt do driver retorna.
Sintaxe
PFND3DDDI_GETENCRYPTIONBLTKEY Pfnd3dddiGetencryptionbltkey;
HRESULT Pfnd3dddiGetencryptionbltkey(
HANDLE hDevice,
const D3DDDIARG_GETENCRYPTIONBLTKEY *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_GETENCRYPTIONBLTKEY que descreve a chave de uma sessão criptografada.
Retornar valor
GetEncryptionBltKey retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | A chave de uma sessão criptografada é recuperada com êxito. |
| D3DDDIERR_NOTAVAILABLE | O driver não dá suporte à função GetEncryptionBltKey. |
Comentários
Opcionalmente, o hardware e o driver podem dar suporte à função GetEncryptionBltKey para todos os tipos de criptografia.
Sempre que o runtime do Direct3D chama a função GetEncryptionBltKey do driver, o driver deve gerar uma nova chave de read-back. Se a função CreateCryptoSession do driver criou anteriormente a sessão de criptografia com o membro CryptoType da estrutura D3DDDIARG_CREATECRYPTOSESSION definida como D3DCRYPTOTYPE_AES128_CTR, o driver e o hardware devem criptografar a chave de leitura com a chave de sessão.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Há suporte para GetEncryptionBltKey a partir do sistema operacional Windows 7. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |