Compartilhar via

PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE função de retorno de chamada (d3dumddi.h)

  • Artigo

A função AuthenticatedChannelKeyExchange negocia a chave de sessão.

Sintaxe

PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3dddiAuthenticatedchannelkeyexchange;

HRESULT Pfnd3dddiAuthenticatedchannelkeyexchange(
  HANDLE hDevice,
  D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE *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_AUTHENTICATEDCHANNELKEYEXCHANGE que descreve um buffer que contém a chave de sessão, que o canal autenticado usa.

Retornar valor

AuthenticatedChannelKeyExchange retorna um dos seguintes valores:

Código de retorno Descrição
S_OK A chave da sessão é negociada com êxito.
E_OUTOFMEMORY AuthenticatedChannelKeyExchange não pôde alocar a memória necessária para que ela fosse concluída.

Comentários

O membro pData na estrutura D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE aponta para um buffer que contém uma chave secreta que um aplicativo anteriormente RSAES-OAEP criptografava com a chave pública do certificado de canal autenticado do driver. O tamanho real do buffer é de 256 bytes. Essa troca é idêntica à forma como a troca de chaves do OPM ( Output Protection Manager ) funciona, exceto que o buffer do OPM contém dados adicionais além da chave de sessão. O mesmo certificado usado para troca de chaves OPM pode ser usado para o canal autenticado.

O driver descriptografa essa chave secreta e usa a chave secreta em chamadas para as funções ConfigureAuthenticatedChannel e QueryAuthenticatedChannel do driver para calcular códigos de autenticação de mensagem do modo CBC (Encadeamento de Criptografia de Codificação de Uma Chave) (OMACs).

Requisitos

Requisito Valor
Cliente mínimo com suporte O AuthenticatedChannelKeyExchange tem suporte a partir do sistema operacional Windows 7.
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE