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 [dentro, fora]
Um ponteiro para uma estrutura D3DDDIARG_STARTSESSIONKEYREFRESH que contém informações sobre o número aleatório.
Valor de retorno
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. |
Observações
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 pRandomNumber membro da estrutura D3DDDIARG_STARTSESSIONKEYREFRESH 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 |
|---|---|
| de cliente com suporte mínimo | StartSessionKeyRefresh tem suporte a partir do sistema operacional Windows 7. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |