PFND3D11_1DDI_QUERYAUTHENTICATEDCHANNEL fungsi panggilan balik (d3d10umddi.h)

Artikel
03/08/2023

Mengkueri saluran terautentikasi untuk kapabilitas dan informasi status. Diimplementasikan oleh Driver Tampilan Windows Model (WDDM) 1.2 atau driver tampilan mode pengguna yang lebih baru.

Sintaks

PFND3D11_1DDI_QUERYAUTHENTICATEDCHANNEL Pfnd3d111DdiQueryauthenticatedchannel;

HRESULT Pfnd3d111DdiQueryauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT InputDataSize,
  const VOID *pInputData,
  UINT OutputDataSize,
  VOID *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, data dalam array pInputData .

pInputData

Penunjuk ke buffer yang menjelaskan informasi untuk kueri. Data dalam buffer ini diformat sebagai struktur D3D11_1DDI_AUTHENTICATED_QUERY_INPUT .

OutputDataSize

Ukuran, dalam byte, data dalam array pOutputData .

pOutputData

Penunjuk ke buffer yang berisi informasi yang dikueri. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Mengembalikan nilai

Mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
S_OK	Saluran terautentikasi berhasil dikueri.
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

Parameter pInputData mereferensikan buffer yang berisi struktur D3D11_1DDI_AUTHENTICATED_QUERY_INPUT . Struktur ini berisi handel driver ke saluran terautentikasi, nomor urut, dan GUID yang menunjukkan jenis kueri yang akan dilakukan. Driver harus mengembalikan E_INVALIDARG jika nomor urutan sebelumnya tidak diinisialisasi dengan menggunakan fungsi ConfigureAuthenticatedChannel(D3D11_1). Driver juga harus mengembalikan E_INVALIDARG jika nomor urut tidak lebih besar dari nomor urut panggilan kueri sebelumnya.

Array byte yang dirujuk oleh parameter pOutputData berada dalam format yang ditentukan oleh anggota QueryType dari struktur D3D11_1DDI_AUTHENTICATED_QUERY_INPUT . Daftar berikut ini menjelaskan format data ini berdasarkan anggota QueryType .

Driver menyiapkan buffer output yang dirujuk oleh parameter pOutputData dengan mengikuti langkah-langkah berikut:

Setiap struktur yang dikembalikan berdasarkan anggota QueryType dimulai dengan struktur D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT . Driver harus menyalin anggota D3D11_1DDI_AUTHENTICATED_QUERY_INPUT ke struktur D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT .
Driver harus mengatur anggota ReturnCode ke kode pengembalian yang sama dengan yang akan dikembalikan untuk panggilan QueryAuthenticatedChannel(D3D11_1). Ini memberi aplikasi mekanisme yang aman untuk mengakses kode pengembalian.
Berdasarkan nilai anggota QueryType , driver harus menginisialisasi struktur terkait yang mengikuti struktur D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT dalam buffer pOutputData .
Driver harus menandatangani buffer pOutputData dengan cara yang identik dengan caranya menangani kueri Output Protection Manager (OPM).
Struktur D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT berisi kode autentikasi pesan CBC satu kunci (OMAC) berbasis AES dari data. Driver miniport tampilan harus menghitung OMAC atas data dalam buffer output untuk mengautentikasi data. Driver melakukan ini dengan terlebih dahulu mengatur anggota omac ke nol dan kemudian menghitung OMAC untuk data dalam buffer. Driver kemudian mengatur anggota omac ke OMAC yang dihitungnya.

Driver miniport tampilan harus mengembalikan E_INVALIDARG untuk panggilan QueryAuthenticatedChannel(D3D11_1) dalam kondisi berikut:

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 OutputDataSize kurang dari ukuran struktur yang ditentukan oleh D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT. Anggota QueryType .

Persyaratan

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

Lihat juga

MengonfigurasiAuthenticatedChannel(D3D11_1)

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDI_AUTHENTICATED_QUERY_INPUT

D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT

Bagikan melalui