PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE função de retorno de chamada (d3dumddi.h)
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) |