PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE コールバック関数 (d3dumddi.h)
AuthenticatedChannelKeyExchange 関数は、セッション キーをネゴシエートします。
構文
PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3dddiAuthenticatedchannelkeyexchange;
HRESULT Pfnd3dddiAuthenticatedchannelkeyexchange(
HANDLE hDevice,
D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE *unnamedParam2
)
{...}
パラメーター
hDevice
ディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。
unnamedParam2
pData [in, out]
認証された チャネルが使用 するセッション キーを含むバッファーを記述するD3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE構造体へのポインター。
戻り値
AuthenticatedChannelKeyExchange は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| S_OK | セッション キーが正常にネゴシエートされました。 |
| E_OUTOFMEMORY | AuthenticatedChannelKeyExchange が完了するために必要なメモリを割り当てませんでした。 |
注釈
D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE構造体の pData メンバーは、ドライバーの認証済みチャネル証明書の公開キーを使用してアプリケーションが以前 RSAES-OAEP で暗号化した秘密キーを含むバッファーを指します。 バッファーの実際のサイズは 256 バイトです。 この交換は 、OUTPUT Protection Manager (OPM) キー交換のしくみと同じですが、OPM バッファーにはセッション キー以外の追加データが含まれています。 認証されたチャネルには、OPM キー交換に使用されるのと同じ証明書を使用できます。
ドライバーはこの秘密キーを復号化し、ドライバーの ConfigureAuthenticatedChannel 関数と QueryAuthenticatedChannel 関数の呼び出しで秘密キーを使用して、1 キー暗号ブロック チェーン (CBC) モードのメッセージ認証コード (OMAC) を計算します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | AuthenticatedChannelKeyExchange は、Windows 7 オペレーティング システム以降でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |