Bagikan melalui

IOPMVideoOutput::Metode FinishInitialization (opmapi.h)

  • Artikel

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

Sintaks

HRESULT FinishInitialization(
  [in] const OPM_ENCRYPTED_INITIALIZATION_PARAMETERS *pParameters
);

Parameter

[in] pParameters

Arahkan ke struktur OPM_ENCRYPTED_INITIALIZATION_PARAMETERS . Inisialisasi struktur ini seperti yang dijelaskan dalam sesi Keterangan.

Nilai kembali

Mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
ERROR_GRAPHICS_OPM_DRIVER_INTERNAL_ERROR
 Terjadi kesalahan tak terduga pada pengandar tampilan.
ERROR_GRAPHICS_OPM_INVALID_ENCRYPTED_PARAMETERS
 Parameter terenkripsi dalam pParameters salah.

Keterangan

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

Parameter pParameters menunjuk ke struktur OPM_ENCRYPTED_INITIALIZATION_PARAMETERS yang berisi array 256 byte. Sebelum memanggil metode , siapkan array ini sebagai berikut. Pertama, menggabungkan angka-angka berikut:

  • Angka 128-bit dikembalikan dalam parameter prnRandomNumber dari metode IOPMVideoOutput::StartInitialization .
  • Kunci penandatanganan AES. Nilai ini adalah angka acak 128-bit yang dihasilkan oleh aplikasi.
  • Nomor urutan awal untuk permintaan status OPM. Nilai ini adalah angka acak 32-bit yang dihasilkan oleh aplikasi.
  • Nomor urutan awal untuk perintah OPM. Nilai ini adalah angka acak 32-bit yang dihasilkan oleh aplikasi.
Enkripsi nomor ini dengan RAEAS-OAEP, enkripsi menggunakan kunci enkripsi publik driver tampilan. Kunci enkripsi publik terkandung dalam sertifikat yang dikembalikan dalam parameter ppbCertificate dari metode StartInitialization .

Aplikasi harus menggunakan angka acak yang aman secara kriptografis. Fungsi CryptGenRandom direkomendasikan, meskipun tidak diperlukan.

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