Metode IOPMVideoOutput::StartInitialization (opmapi.h)
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 |