PFND3DDDI_CRYPTOSESSIONKEYEXCHANGE コールバック関数 (d3dumddi.h)

  • [アーティクル]

CryptoSessionKeyExchange 関数はセッション キーをネゴシエートします。

構文

PFND3DDDI_CRYPTOSESSIONKEYEXCHANGE Pfnd3dddiCryptosessionkeyexchange;

HRESULT Pfnd3dddiCryptosessionkeyexchange(
  HANDLE hDevice,
  D3DDDIARG_CRYPTOSESSIONKEYEXCHANGE *unnamedParam2
)
{...}

パラメーター

hDevice

ディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。

unnamedParam2

pData [in, out]

暗号化に使用されるセッション キーを記述する D3DDDIARG_CRYPTOSESSIONKEYEXCHANGE 構造体へのポインター。

戻り値

CryptoSessionKeyExchange は、次のいずれかの値を返します。

リターン コード 説明
S_OK セッション キーが正常に交換されました。
E_OUTOFMEMORY CryptoSessionKeyExchange は、完了するために必要なメモリを割り当てませんでした。

注釈

ドライバーは、暗号化の種類ごとに 1 つのキー交換メカニズムのみをサポートする必要があります。 Microsoft では、キー交換の種類のD3DKEYEXCHANGE_RSAES_OAEPを標準化しました。 ただし、ハードウェア ベンダーは、独自のキー交換メカニズムを使用できます。

D3DKEYEXCHANGE_RSAES_OAEPの場合、D3DDDIARG_CRYPTOSESSIONKEYEXCHANGE構造体の pData メンバーは、アプリケーションがドライバーの暗号化セッション証明書の公開キーを使用して以前に RSAES-OAEP で暗号化されたセッション キーを含むバッファーを指します。 バッファーの実際のサイズは 256 バイトです。 この交換は 、OUTPUT Protection Manager (OPM) キー交換のしくみと同じですが、OPM バッファーにはセッション キー以外の追加データが含まれています。 OPM キー交換に使用されるのと同じ証明書を、D3DKEYEXCHANGE_RSAES_OAEPキー交換に使用できます。

要件

要件 値
サポートされている最小のクライアント CryptoSessionKeyExchange は、Windows 7 オペレーティング システム以降でサポートされています。
対象プラットフォーム デスクトップ
Header d3dumddi.h (D3dumddi.h を含む)

こちらもご覧ください

D3DDDIARG_CRYPTOSESSIONKEYEXCHANGE