PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL fungsi panggilan balik (d3dumddi.h)

  • Artikel

Fungsi ConfigureAuthenticatedChannel menetapkan status dalam saluran yang diautentikasi.

Sintaks

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;

HRESULT Pfnd3dddiConfigureauthenicatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

unnamedParam2

pData [masuk, keluar]

Penunjuk ke struktur D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL yang menjelaskan cara mengonfigurasi saluran yang diautentikasi. Struktur ini berisi buffer input yang menjelaskan cara mengonfigurasi saluran terautentikasi dan buffer output dengan informasi konfigurasi.

Menampilkan nilai

ConfigureAuthenticatedChannel mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
S_OK Saluran terautentikasi berhasil dikonfigurasi.
E_OUTOFMEMORY ConfigureAuthenticatedChannel tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.

Keterangan

Buffer input berisi kode autentikasi pesan mode One-key Cipher Block Chaining (CBC) (OMAC) yang harus diautentikasi driver. Buffer input juga berisi handel driver ke saluran yang diautentikasi, nomor urut, dan GUID yang menunjukkan jenis konfigurasi.

Driver harus gagal ConfigureAuthenticatedChannel jika input OMAC tidak cocok, jika nomor urut tidak lebih besar dari nomor urut yang ditentukan dalam panggilan sebelumnya, atau jika nomor urutan belum diinisialisasi (pengecualian untuk aturan terakhir ini adalah untuk panggilan inisialisasi itu sendiri).

Driver harus menduplikasi data input dalam struktur buffer output dan harus menandatangani struktur output secara identik dengan cara saat ini menangani kueri Output Protection Manager (OPM).

Kecuali untuk situasi di mana aplikasi salah menentukan buffer output yang terlalu kecil, driver harus selalu menempatkan kode pengembalian dalam struktur output. Oleh karena itu, aplikasi memiliki mekanisme yang aman untuk menentukan kode pengembalian.

ConfigureAuthenticatedChannel melakukan operasi yang berbeda tergantung pada setiap GUID berikut yang ditentukan dalam struktur input. Driver harus gagal jika ukuran buffer input tidak cocok dengan ukuran yang ditentukan untuk GUID yang ditentukan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung ConfigureAuthenticatedChannel didukung dimulai dengan sistem operasi Windows 7.
Target Platform Desktop
Header d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL