Fungsi StreamClassGetNextEvent (strmini.h)

  • Artikel

Minidriver dapat menggunakan rutinitas StreamClassGetNextEvent untuk mencari antrean peristiwa perangkat atau aliran tertentu.

Sintaks

PKSEVENT_ENTRY StreamClassGetNextEvent(
  [in, optional] PVOID             HwInstanceExtension_OR_HwDeviceExtension,
  [in, optional] PHW_STREAM_OBJECT HwStreamObject,
  [in, optional] GUID              *EventGuid,
  [in]           ULONG             EventItem,
  [in, optional] PKSEVENT_ENTRY    CurrentEvent
);

Parameter

[in, optional] HwInstanceExtension_OR_HwDeviceExtension

Arahkan ke ekstensi perangkat minidriver. Minidriver menentukan ukuran buffer ini dalam struktur HW_INITIALIZATION_DATA yang diteruskannya ketika mendaftarkan dirinya melalui StreamClassRegisterMinidriver. Driver kelas kemudian meneruskan pointer ke buffer di anggota HwDeviceExtension dari struktur HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXT, dan PORT_CONFIGURATION_INFORMATION yang diteruskannya ke minidriver.

Parameter pertama ini adalah PVOID HwDeviceExtension. Ini HARUS HwInstanceExtension untuk driver jenis multi-instans dan multi-filter (versi 20). Driver instans tunggal warisan dapat terus menentukan HwDeviceExtension sebagai parameter pertama. Ini juga dapat menentukan HwInstanceExtension.

[in, optional] HwStreamObject

Arahkan ke HW_STREAM_OBJECT. Atur ke NULL untuk mencari antrean peristiwa perangkat itu sendiri. Untuk mencari antrean peristiwa aliran tertentu, atur ke objek stream.

[in, optional] EventGuid

Menentukan set peristiwa yang akan dicocokkan saat menjalankan antrean, atau NULL agar sesuai dengan set peristiwa apa pun.

[in] EventItem

Menentukan ID peristiwa yang akan dicocokkan saat menjalankan antrean, atau -1 agar sesuai dengan peristiwa apa pun.

[in, optional] CurrentEvent

Arahkan ke peristiwa dalam antrean peristiwa, atau NULL.

Nilai kembali

Jika CurrentEvent bukan NULL, StreamClassGetNextEvent mengembalikan peristiwa yang cocok berikutnya setelah CurrentEvent dalam antrean (atau NULL jika tidak ada peristiwa berikutnya). Jika CurrentEventADALAH NULL, StreamClassGetNextEvent mengembalikan peristiwa pencocokan pertama dalam antrean.

Keterangan

Minidriver dapat memanggil StreamClassGetNextEvent secara berturut-turut untuk mengulangi antrean peristiwa, memeriksa satu peristiwa pada satu waktu.

Pemanggil dapat menentukan kriteria pencarian tambahan untuk mencocokkan peristiwa pada antrean peristiwa.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header strmini.h (termasuk Strmini.h)
Pustaka Stream.lib