PFND3DDDI_QUERYAUTHENTICATEDCHANNEL fungsi panggilan balik (d3dumddi.h)

  • Artikel

Fungsi QueryAuthenticatedChannel meminta saluran terautentikasi untuk informasi kemampuan dan status.

Sintaks

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;

HRESULT Pfnd3dddiQueryauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

unnamedParam2

pData [masuk, keluar]

Penunjuk ke struktur D3DDDIARG_QUERYAUTHENTICATEDCHANNEL yang menjelaskan informasi saluran terautentikasi untuk kueri. Struktur ini berisi buffer input yang menjelaskan kueri dan buffer output untuk mengembalikan informasi yang dikueri.

Menampilkan nilai

QueryAuthenticatedChannel mengembalikan salah satu nilai berikut:

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

Keterangan

Buffer input berisi handel driver ke saluran yang diautentikasi, nomor urut, dan GUID yang menunjukkan jenis kueri. Driver harus gagal semua kueri jika driver sebelumnya tidak menginisialisasi nomor urutan melalui panggilan ke fungsi ConfigureAuthenticatedChannel . Driver juga harus gagal kueri jika nomor urutan tidak lebih besar dari nomor urut panggilan kueri sebelumnya.

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.

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

Persyaratan

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

Lihat juga

MengonfigurasiAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL