Fungsi KsGenerateDataEvent (ks.h)

Fungsi KsGenerateDataEvent menghasilkan salah satu pemberitahuan peristiwa standar ketika diberikan struktur entri peristiwa dan data panggilan balik. Ini memungkinkan perangkat untuk menentukan kapan pemberitahuan peristiwa harus dibuat, namun masih menggunakan fungsi pembantu ini untuk melakukan pemberitahuan aktual.

Sintaks

KSDDKAPI NTSTATUS KsGenerateDataEvent(
  [in] PKSEVENT_ENTRY EventEntry,
  [in] ULONG          DataSize,
  [in] PVOID          Data
);

Parameter

[in] EventEntry

Menentukan struktur entri peristiwa yang mereferensikan data peristiwa. Informasi ini digunakan untuk menentukan jenis pemberitahuan apa yang akan dilakukan. Jika jenis pemberitahuan bukan salah satu standar yang telah ditentukan sebelumnya, kesalahan akan dikembalikan. Dalam kasus peristiwa tunggal yang tidak dihasilkan, entri ini akan tidak valid ketika dikembalikan dari fungsi. Oleh karena itu, kode apa pun yang menghitung daftar peristiwa harus dibuat sebelumnya untuk memperoleh peristiwa berikutnya dalam daftar sebelum meneruskan peristiwa ini ke fungsi.

[in] DataSize

Menentukan ukuran dalam byte parameter Data yang diteruskan.

[in] Data

Menunjuk ke data yang akan diteruskan ke panggilan balik klien. Data ini disalin ke salah satu slot buffer yang telah dialokasikan sebelumnya yang disiapkan saat peristiwa diaktifkan. Ukuran data harus kurang dari apa pun yang awalnya dialokasikan atau peristiwa akan gagal.

Nilai kembali

Fungsi KsGenerateDataEvent mengembalikan STATUS_SUCCESS jika berhasil, atau jika tidak berhasil, fungsi tersebut mengembalikan pengecualian atau kesalahan memori.

Keterangan

Diasumsikan bahwa kunci daftar peristiwa telah diperoleh sebelum fungsi ini dipanggil. Fungsi ini dapat menghasilkan panggilan ke RemoveHandler untuk entri peristiwa. Oleh karena itu, fungsi tidak boleh dipanggil lebih tinggi dari tingkat IRQ kunci, atau fungsi Hapus harus dapat menangani dipanggil pada tingkat IRQ seperti itu.

Fungsi ini khusus untuk peristiwa yang meneruskan data kembali melalui panggilan balik ke klien.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ks.h (termasuk Ks.h)
Pustaka	Ks.lib

Lihat juga

KSBUFFER_ITEM