Metode IAMCertifiedOutputProtection::KeyExchange (strmif.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode KeyExchange mengembalikan sertifikat driver grafis.

Sintaks

HRESULT KeyExchange(
  [out] GUID  *pRandom,
  [out] BYTE  **VarLenCertGH,
  [out] DWORD *pdwLengthCertGH
);

Parameter

[out] pRandom

Menerima angka acak 128-bit, yang dihasilkan oleh driver grafis. Gunakan nilai ini dalam metode IAMCertifiedOutputProtection::SessionSequenceStart .

[out] VarLenCertGH

Menerima penunjuk ke buffer yang berisi sertifikat driver grafis. Metode mengalokasikan memori untuk buffer. Pemanggil harus melepaskan memori dengan memanggil CoTaskMemFree.

[out] pdwLengthCertGH

Menerima panjang buffer yang dikembalikan di VarLenCertGH.

Mengembalikan nilai

Mengembalikan nilai HRESULT. Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_UNEXPECTED	Status tidak valid. Mungkin aplikasi meneruskan data tak terduga, atau disebut metode IAMCertifiedOutputProtection dalam urutan yang salah. Jika kesalahan ini terjadi, aplikasi harus merilis instans VMR saat ini.
VFW_E_NO_COPP_HW	Perangkat tampilan tidak mendukung COPP; atau VMR belum tersambung ke perangkat tampilan.
ERROR_GRAPHICS_NO_MONITORS_CORRESPOND_TO_DISPLAY_DEVICE	Tidak ada monitor yang sesuai dengan perangkat tampilan. Kesalahan ini dapat terjadi jika mode tampilan berubah; atau pengguna menonaktifkan monitor atau menghapus monitor.

Keterangan

Sertifikat driver grafis berisi kunci enkripsi publik driver.

Jika metode ini mengembalikan E_UNEXPECTED, aplikasi harus membuat sesi COPP baru dengan merilis VMR, membuat instans baru VMR, dan memanggil KeyExchange lagi pada instans baru.

Persyaratan


Klien minimum yang didukung	Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Antarmuka IAMCertifiedOutputProtection

Menggunakan Protokol Perlindungan Output Bersertifikat (COPP)

Bagikan melalui