Compartilhar via

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

  • Artigo

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

Sintaxe

PFND3DWDDM2_4DDI_NEGOTIATECRYPTOSESSIONKEYEXCHANGE Pfnd3dwddm24DdiNegotiatecryptosessionkeyexchange;

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

Parâmetros

hDevice

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

hCryptoSession

Um identificador para os dados privados do driver para a sessão criptográfica. Esse identificador foi criado pelo runtime do Direct3D e passado para o driver na chamada para CreateCryptoSession.

flags

O valor do sinalizador para a função.

DataSize

O tamanho, em bytes, dos dados para os quais o membro pData aponta.

pData

Um ponteiro para um buffer que contém a chave de sessão criptografada.

Retornar valor

Retorna um dos seguintes valores HRESULT:

Código de retorno Descrição
S_OK A chave de sessão para a 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.

Comentários

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 – Preenchimento de Criptografia Assimétrica Ideal (RSAES-OAEP), o buffer de chave deve conter 256 bytes de dados e deve ser criptografado usando o algoritmo RSA Encryption Scheme – Preenchimento de Criptografia Assimétrica Ideal (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 (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 a sessão criptográfica e a chave de sessão OPM.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d10umddi.h (inclua S3d10umddi.h)