struktur OPM_GET_INFO_PARAMETERS (ksopmapi.h)

Artikel
08/24/2023

Berisi parameter untuk metode IOPMVideoOutput::GetInformation .

Sintaks

typedef struct _OPM_GET_INFO_PARAMETERS {
  OPM_OMAC          omac;
  OPM_RANDOM_NUMBER rnRandomNumber;
  GUID              guidInformation;
  ULONG             ulSequenceNumber;
  ULONG             cbParametersSize;
  BYTE              abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE];
} OPM_GET_INFO_PARAMETERS;

Anggota

omac

Struktur OPM_OMAC yang berisi kode autentikasi pesan (MAC) untuk data di struktur lainnya.

rnRandomNumber

Struktur OPM_RANDOM_NUMBER yang berisi angka acak 128-bit yang aman secara kriptografis.

guidInformation

GUID yang menentukan permintaan status. Untuk informasi selengkapnya, lihat Permintaan Status OPM.

ulSequenceNumber

Nomor urutan status. Aplikasi harus menyimpan jumlah permintaan status yang berjalan. Untuk setiap permintaan, tingkatkan angka urutan sebesar 1.

Pada panggilan pertama ke GetInformation, atur ulSequenceNumber sama dengan nomor urutan status awal, yang ditentukan ketika aplikasi memanggil IOPMVideoOutput::FinishInitialization. Pada setiap panggilan berikutnya, kenaikan ulSequenceNumber sebesar 1.

Pengecualian: Jika permintaan status gagal, jangan menaikkan nomor urut. Sebagai gantinya, gunakan kembali nomor yang sama untuk permintaan status berikutnya.

cbParametersSize

Jumlah byte data yang valid di anggota abParameters .

abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE]

Data untuk permintaan status. Arti data tergantung pada permintaan. Untuk informasi selengkapnya, lihat Permintaan Status OPM.

Keterangan

Inisialisasi struktur ini sebagai berikut:

Hasilkan angka acak 128-bit yang aman secara kriptografis dan salin ke anggota rnRandomNumber . Jangan gunakan kembali nomor ini setelah memanggil GetInformation.
Isi anggota struktur yang tersisa, 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


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	ksopmapi.h (termasuk Opmapi.h)

Lihat juga

Struktur OPM

Manajer Perlindungan Output

Bagikan melalui