PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE função de retorno de chamada (d3d10umddi.h)

Artigo
02/06/2025

Estabelece uma chave de sessão para um objeto de sessão criptográfica.

Sintaxe

PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE Pfnd3d111DdiNegotiatecryptosessionkeyeschange;

HRESULT Pfnd3d111DdiNegotiatecryptosessionkeyeschange(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HCRYPTOSESSION hCryptoSession,
  UINT DataSize,
  BYTE *pData
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

hCryptoSession

Um identificador para o objeto de sessão criptográfica que foi criado por meio de uma chamada para a função CreateCryptoSession.

DataSize

O tamanho, em bytes, dos dados na matriz de pData.

pData

Um ponteiro para uma matriz de bytes que contém a chave de sessão criptografada.

Valor de retorno

NegotiateCryptoSessionKeyExchange retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	A chave de sessão da sessão criptográfica 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.

Observações

O parâmetro pData faz referência a um buffer que contém uma chave de sessão para a sessão criptográfica. O mecanismo de troca de chaves depende do tipo do algoritmo de criptografia usado pela sessão criptográfica.

Para sessões que usam o algoritmo RSA Encryption Scheme – Otimizado para Preenchimento de Criptografia Assimétrica (RSAES-OAEP), o buffer de chave deve conter 256 bytes de dados e deve ser criptografado usando o algoritmo RSA Encryption Scheme – Ideal Assimétrico Encryption Padding (RSAES-OAEP) com a chave pública do certificado de sessão criptográfica.

A troca de chaves para uma sessão criptográfica é idêntica à troca de chaves para a interface do OPM (Output Protection Manager). 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 a sessão criptográfica e a chave de sessão do OPM.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Área de trabalho
cabeçalho	d3d10umddi.h (inclua D3d10umddi.h)

Consulte também

CreateCryptoSession

Partilhar via