Metode IAMCertifiedOutputProtection::KeyExchange (strmif.h)
[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 |
---|---|
|
Berhasil. |
|
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. |
|
Perangkat tampilan tidak mendukung COPP; atau VMR belum tersambung ke perangkat tampilan. |
|
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)