PFND3DDDI_STARTSESSIONKEYREFRESH função de retorno de chamada (d3dumddi.h)
A função StartSessionKeyRefresh retorna um número aleatório que a função FinishSessionKeyRefresh do driver usa posteriormente para executar uma operação OR exclusiva (XOR) com a chave de sessão.
Sintaxe
PFND3DDDI_STARTSESSIONKEYREFRESH Pfnd3dddiStartsessionkeyrefresh;
HRESULT Pfnd3dddiStartsessionkeyrefresh(
HANDLE hDevice,
const D3DDDIARG_STARTSESSIONKEYREFRESH *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_STARTSESSIONKEYREFRESH que contém informações sobre o número aleatório.
Retornar valor
StartSessionKeyRefresh retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | O número aleatório é retornado com êxito. |
| D3DDDIERR_NOTAVAILABLE | O driver não dá suporte à função StartSessionKeyRefresh. |
Comentários
Opcionalmente, o hardware e o driver podem dar suporte a StartSessionKeyRefresh para todos os tipos de criptografia.
Quando o runtime do Direct3D chama a função StartSessionKeyRefresh do driver, o driver gera e salva um número aleatório e retorna o número aleatório no buffer para o qual o membro pRandomNumber do D3DDDIARG_STARTSESSIONKEYREFRESH estrutura aponta.
Quando o runtime chama posteriormente a função FinishSessionKeyRefresh do driver, o driver executa uma operação XOR do número aleatório com a chave de sessão.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | StartSessionKeyRefresh tem suporte a partir do sistema operacional Windows 7. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |