Metode IOPMVideoOutput::StartInitialization (opmapi.h)

Artikel
08/25/2023

Memulai urutan inisialisasi untuk sesi Output Protection Manager (OPM).

Sintaks

HRESULT StartInitialization(
  [out] OPM_RANDOM_NUMBER *prnRandomNumber,
  [out] BYTE              **ppbCertificate,
  [out] ULONG             *pulCertificateLength
);

Parameter

[out] prnRandomNumber

Penunjuk ke struktur OPM_RANDOM_NUMBER . Struktur menerima angka acak 128-bit yang dihasilkan oleh driver tampilan. Jumlah ini diperlukan untuk metode IOPMVideoOutput::FinishInitialization .

[out] ppbCertificate

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

[out] pulCertificateLength

Menerima panjang buffer yang diarahkan oleh ppbCertificate.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini setara dengan metode IAMCertifiedOutputProtection::KeyExchange dalam Certified Output Protection Protocol (COPP).

Metode ini mengembalikan rantai sertifikat yang berisi kunci umum RSA driver 2048-bit. Pemanggil harus memvalidasi rantai sertifikat lalu memanggil IOPMVideoOutput::FinishInitialization untuk membuat sesi OPM.

Metode ini mendukung semantik OPM dan semantik COPP. Semantik COPP didukung untuk kompatibilitas mundur; aplikasi baru harus menggunakan semantik OPM.

Semantik OPM

Metode mengembalikan rantai sertifikat X.509. Rantai sertifikat dikodekan dengan ASN.1 Distinguished Encoding Rules (DER).

Semantik COPP

Metode mengembalikan rantai sertifikat COPP. Rantai sertifikat dikembalikan sebagai string UTF-8. Anda dapat memperlakukan buffer yang dikembalikan dalam ppbCertificate sebagai array chars.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	opmapi.h

Lihat juga

IOPMVideoOutput

Manajer Perlindungan Output

Share via