PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE função de retorno de chamada (d3d10umddi.h)
Estabelece uma chave de sessão para um canal autenticado.
Sintaxe
PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange;
HRESULT Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
UINT DataSize,
VOID *pData
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico).
hCAuthChannel
Um identificador para um objeto de canal autenticado que foi criado por meio de uma chamada para a função CreateAuthenticatedChannel(D3D11_1).
DataSize
O tamanho, em bytes, dos dados na matriz pData .
pData
Um ponteiro para uma matriz de bytes que contém a chave de sessão criptografada.
Retornar valor
NegotiateAuthenticatedChannelKeyExchange retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | A chave de sessão para o canal autenticado foi negociada com êxito. |
| E_INVALIDARG | Os parâmetros foram validados e determinados como incorretos. |
| E_OUTOFMEMORY | A memória não estava disponível para concluir a operação. |
Comentários
O parâmetro pData faz referência a um buffer que contém uma chave de sessão para o canal autenticado. Esse buffer de chave deve conter 256 bytes de dados e deve ser criptografado usando o algoritmo RSAES-OAEP (Otimização de Preenchimento de Criptografia Assimétrica) com a chave pública do certificado de canal autenticado.
A troca de chaves para um canal autenticado é idêntica à troca de chaves para a interface do OPM (Gerenciador de Proteção de Saída). No entanto, o buffer de chave OPM contém dados adicionais além da chave de sessão.
Observação
O mesmo certificado pode ser usado para o canal autenticado e a chave de sessão OPM.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3d10umddi.h (inclua D3d10umddi.h) |