PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE fungsi panggilan balik (d3dumddi.h)
Fungsi AuthenticatedChannelKeyExchange menegosiasikan kunci sesi.
Sintaks
PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3dddiAuthenticatedchannelkeyexchange;
HRESULT Pfnd3dddiAuthenticatedchannelkeyexchange(
HANDLE hDevice,
D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE *unnamedParam2
)
{...}
Parameter
hDevice
Handel ke perangkat tampilan (konteks grafis).
unnamedParam2
pData [masuk, keluar]
Penunjuk ke struktur D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE yang menjelaskan buffer yang berisi kunci sesi, yang digunakan saluran terautentikasi.
Menampilkan nilai
AuthenticatedChannelKeyExchange mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| S_OK | Kunci sesi berhasil dinegosiasikan. |
| E_OUTOFMEMORY | AuthenticatedChannelKeyExchange tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya. |
Keterangan
Anggota pData dalam struktur D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE menunjuk ke buffer yang berisi kunci rahasia yang sebelumnya dienkripsi RSAES-OAEP dengan kunci umum dari sertifikat saluran yang diautentikasi driver. Ukuran aktual buffer adalah 256 byte. Pertukaran ini identik dengan cara kerja pertukaran kunci Output Protection Manager (OPM), kecuali buffer OPM berisi data tambahan selain kunci sesi. Sertifikat yang sama yang digunakan untuk pertukaran kunci OPM dapat digunakan untuk saluran yang diautentikasi.
Driver mendekripsi kunci rahasia ini dan menggunakan kunci rahasia dalam panggilan ke fungsi ConfigureAuthenticatedChannel dan QueryAuthenticatedChannel driver untuk menghitung kode autentikasi pesan mode Satu Kunci Cipher Block Chaining (CBC).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | AuthenticatedChannelKeyExchange didukung dimulai dengan sistem operasi Windows 7. |
| Target Platform | Desktop |
| Header | d3dumddi.h (termasuk D3dumddi.h) |