PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE callback function (d3dumddi.h)
The AuthenticatedChannelKeyExchange function negotiates the session key.
Syntax
PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3dddiAuthenticatedchannelkeyexchange;
HRESULT Pfnd3dddiAuthenticatedchannelkeyexchange(
HANDLE hDevice,
D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE *unnamedParam2
)
{...}
Parameters
hDevice
A handle to the display device (graphics context).
unnamedParam2
pData [in, out]
A pointer to a D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE structure that describes a buffer that contains the session key, which the authenticated channel uses.
Return value
AuthenticatedChannelKeyExchange returns one of the following values:
| Return code | Description |
|---|---|
| S_OK | The session key is successfully negotiated. |
| E_OUTOFMEMORY | AuthenticatedChannelKeyExchange could not allocate the required memory for it to complete. |
Remarks
The pData member in the D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE structure points to a buffer that contains a secret key that an application previously RSAES-OAEP-encrypted with the public key from the driver's authenticated channel certificate. The actual size of the buffer is 256 bytes. This exchange is identical to how the Output Protection Manager (OPM) key exchange works, except the OPM buffer contains additional data besides the session key. The same certificate that is used for OPM key exchange can be used for the authenticated channel.
The driver decrypts this secret key and uses the secret key in calls to the driver's ConfigureAuthenticatedChannel and QueryAuthenticatedChannel functions to calculate One-key Cipher Block Chaining (CBC)-mode message authentication codes (OMACs).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | AuthenticatedChannelKeyExchange is supported beginning with the Windows 7 operating system. |
| Target Platform | Desktop |
| Header | d3dumddi.h (include D3dumddi.h) |