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 [dentro, fora]
Um ponteiro para uma estrutura de D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE que descreve um buffer que contém a chave de sessão, que o canal autenticado usa.
Valor de retorno
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. |
Observações
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 à maneira como a troca de chaves do do Output Protection Manager (OPM) 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 do driver e queryAuthenticatedChannel para calcular códigos de autenticação de mensagem do modo CBC (Encadeamento de Blocos de Criptografia) de uma chave para calcular códigos de autenticação de mensagem do modo CBC (Encadeamento de Código de Criptografia).
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | O AuthenticatedChannelKeyExchange tem suporte a partir do sistema operacional Windows 7. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |