PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL fungsi panggilan balik (d3d10umddi.h)

Memproses permintaan dari aplikasi untuk mengonfigurasi saluran terautentikasi untuk perlindungan konten. Diimplementasikan oleh Driver Tampilan Windows Model (WDDM) 1.2 atau driver tampilan mode pengguna yang lebih baru.

Sintaks

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Pfnd3d111DdiConfigureauthenticatedchannel;

HRESULT Pfnd3d111DdiConfigureauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT InputDataSize,
  const VOID *pInputData,
  D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT *pOutputData
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

hCAuthChannel

Handel ke objek saluran terautentikasi yang dibuat melalui panggilan ke fungsi CreateAuthenticatedChannel(D3D11_1).

InputDataSize

Ukuran, dalam byte, dari array yang ditentukan oleh parameter pInputData .

pInputData

Penunjuk ke array byte yang berisi data input untuk perintah . Untuk informasi lebih lanjut, lihat bagian Keterangan.

pOutputData

Penunjuk ke struktur D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT . Untuk informasi lebih lanjut, lihat bagian Keterangan.

Mengembalikan nilai

Mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
S_OK Saluran terautentikasi berhasil dikonfigurasi.
E_FAIL Driver miniport tampilan tidak mendukung perintah yang ditentukan
E_INVALIDARG Parameter divalidasi dan ditentukan salah.
E_OUTOFMEMORY Memori tidak tersedia untuk menyelesaikan operasi.

Keterangan

Array byte yang dirujuk oleh parameter pInputData diformat dengan cara berikut:

Daftar berikut ini menjelaskan format data ini berdasarkan anggota ConfigureType .

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION D3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION_GUID

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_ACCESSIBLE_ENCRYPTION D3D11_1DDI_AUTHENTICATED_CONFIGURE_ENCRYPTION_WHEN_ACCESSIBLE_GUID

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE D3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE_GUID

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION D3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION_GUID

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE D3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE_GUID

Struktur D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT berisi kode autentikasi pesan CBC satu kunci (OMAC) berbasis AES dari data. Driver miniport tampilan harus menghitung OMAC sendiri melalui data untuk mengautentikasi data. Struktur input ini juga berisi handel driver ke saluran yang diautentikasi, nomor urut, dan GUID yang menunjukkan jenis konfigurasi.

Driver miniport tampilan mengikuti langkah-langkah ini ketika menginisialisasi struktur D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT :

  1. Driver harus menyalin data input ke struktur D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT .

  2. Driver harus mengatur anggota ReturnCode ke kode pengembalian yang sama yang akan dikembalikan untuk panggilan ConfigureAuthenticatedChannel(D3D11_1). Ini memberi aplikasi mekanisme yang aman untuk mengakses kode pengembalian.

  3. Driver mengatur anggota omac ke nol lalu menghitung OMAC untuk data dalam struktur. Driver kemudian mengatur anggota omac ke OMAC yang dihitungnya

Driver miniport tampilan harus mengembalikan E_INVALIDARG untuk panggilan ConfigureAuthenticatedChannel dalam kondisi berikut:

  • Anggota omac dari strukturD3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT tidak cocok dengan OMAC yang dihitung driver.

  • Nomor urut tidak lebih besar dari nomor urut yang ditentukan dalam panggilan konfigurasi sebelumnya.

  • Nomor urut belum diinisialisasi oleh panggilan ke fungsi ConfigureAuthenticatedChannel(D3D11_1).

  • Parameter InputDataSize kurang dari ukuran struktur D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT ditambah ukuran struktur yang ditentukan oleh D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT. ConfigureTypemember.

Persyaratan

   
Klien minimum yang didukung Windows 8
Server minimum yang didukung Windows Server 2012
Target Platform Desktop
Header d3d10umddi.h (termasuk D3d10umddi.h)

Lihat juga

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT