PFND3DWDDM2_4DDI_NEGOTIATECRYPTOSESSIONKEYEXCHANGE callback function (d3d10umddi.h)

Article
07/19/2021

Establishes a session key for a cryptographic session object.

Syntax

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
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

hCryptoSession

A handle to the driver's private data for the cryptographic session. This handle was created by the Direct3D runtime and passed to the driver in the call to CreateCryptoSession.

flags

The flag value for the function.

DataSize

The size, in bytes, of the data that the pData member points to.

pData

A pointer to a buffer that contains the encrypted session key.

Return value

Returns one of the following HRESULT values:

Return code	Description
S_OK	The session key for the cryptographic session was negotiated successfully.
E_INVALIDARG	Parameters were validated and determined to be incorrect.
E_OUTOFMEMORY	Memory was not available to complete the operation.

Remarks

The pData parameter references a buffer that contains a session key for the cryptographic session. The key exchange mechanism depends on the type of the encryption algorithm that is used by the cryptographic session.

For sessions that use the RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) algorithm, the key buffer must contain 256 bytes of data and must be encrypted by using the RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) algorithm with the public key from the cryptographic session certificate.

The key exchange for a cryptographic session is identical to the key exchange for the Output Protection Manager (OPM) interface. However, the OPM key buffer contains additional data besides the session key.

Note

The same certificate can be used for the cryptographic session and OPM session key.

Requirements

Requirement	Value
Target Platform	Windows
Header	d3d10umddi.h (include S3d10umddi.h)

Share via