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 オペレーティング システム以降でサポートされています。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | d3dumddi.h (D3dumddi.h を含む) |