PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL fungsi panggilan balik (d3d10umddi.h)
Memproses permintaan dari aplikasi untuk mengonfigurasi saluran terautentikasi untuk perlindungan konten. Diimplementasikan oleh driver tampilan Windows Display Driver Model (WDDM) 1.2 atau 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.
Nilai kembali
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:
Array ini dimulai dengan struktur D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT .
Data yang mengikuti struktur ini dalam format yang ditentukan oleh anggota ConfigureType dari struktur.
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 urutan, dan GUID yang menunjukkan jenis konfigurasi.
Driver miniport tampilan mengikuti langkah-langkah ini ketika menginisialisasi struktur D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT :
Driver harus menyalin data input ke struktur D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT .
Driver harus mengatur anggota ReturnCode ke kode pengembalian yang sama dengan yang akan dikembalikan untuk panggilan ConfigureAuthenticatedChannel(D3D11_1). Ini memberi aplikasi mekanisme yang aman untuk mengakses kode pengembalian.
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
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
CreateAuthenticatedChannel(D3D11_1)
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk