struktur OPM_CONFIGURE_PARAMETERS (opmapi.h)
Berisi perintah Output Protection Manager (OPM) atau Certified Output Protection Manager (COPP).
Sintaks
typedef struct _OPM_CONFIGURE_PARAMETERS {
OPM_OMAC omac;
GUID guidSetting;
ULONG ulSequenceNumber;
ULONG cbParametersSize;
BYTE abParameters[4056];
} OPM_CONFIGURE_PARAMETERS;
Anggota
omac
Struktur OPM_MAC . Isi struktur ini dengan Kode Autentikasi Pesan (MAC) dari data perintah. Gunakan CBC MAC satu kunci (OMAC) berbasis AES untuk menghitung nilai ini.
guidSetting
GUID yang menentukan perintah . Untuk informasi selengkapnya, lihat Perintah OPM.
ulSequenceNumber
Nomor urutan perintah. Aplikasi harus menyimpan jumlah perintah yang sedang berjalan. Untuk setiap perintah, tingkatkan nomor urutan satu per satu.
Pada panggilan pertama ke IOPMVideoOutput::Configure, atur ulSequenceNumber sama dengan nomor urutan perintah awal, yang ditentukan saat aplikasi memanggil IOPMVideoOutput::FinishInitialization. Pada setiap panggilan berikutnya, kenaikan ulSequenceNumber sebesar 1.
Pengecualian: Jika metode IOPMVideoOutput::Configure gagal, jangan menaikkan nomor urut. Sebagai gantinya, gunakan kembali angka yang sama untuk perintah berikutnya.
cbParametersSize
Jumlah byte data yang valid di anggota abParameters .
abParameters[4056]
Data untuk perintah . Arti data tergantung pada perintah . Untuk informasi selengkapnya, lihat Perintah OPM.
Keterangan
Tata letak struktur ini identik dengan struktur AMCOPPCommand yang digunakan dalam Certified Output Protection Protocol (COPP).
Inisialisasi struktur ini sebagai berikut.
- Isi semua anggota struktur kecuali anggota omac .
- Gunakan algoritma OMAC 1 untuk menghitung kode autentikasi pesan (MAC) untuk blok data yang muncul setelah anggota omac (tidak termasuk anggota omac ).
- Salin MAC ke anggota omac .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | opmapi.h |