PFND3DDDI_QUERYAUTHENTICATEDCHANNEL fungsi panggilan balik (d3dumddi.h)
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) |