struktur PCEVENT_ITEM (portcls.h)

Struktur PCEVENT_ITEM digunakan untuk menggambarkan peristiwa yang didukung oleh filter, pin, atau simpul tertentu.

Sintaks

typedef struct {
  const GUID         *Set;
  ULONG              Id;
  ULONG              Flags;
  PCPFNEVENT_HANDLER Handler;
} PCEVENT_ITEM, *PPCEVENT_ITEM;

Anggota

Set

Menentukan set peristiwa. Anggota ini adalah penunjuk ke GUID yang secara unik mengidentifikasi kumpulan peristiwa. Lihat daftar GUID yang diatur peristiwa di Set Peristiwa Driver Audio.

Id

Menentukan ID peristiwa. Anggota ini mengidentifikasi item peristiwa dalam set peristiwa. Jika kumpulan peristiwa berisi item N, ID peristiwa yang valid adalah bilangan bulat dalam rentang 0 hingga N-1.

Flags

Menentukan jenis peristiwa. Anggota ini diatur ke salah satu nilai berikut:

PCEVENT_ITEM_FLAG_ENABLE

Menunjukkan pemberitahuan peristiwa harus diaktifkan untuk jenis kejadian ini. Driver harus melanjutkan pemberitahuan peristiwa hingga klien secara eksplisit menonaktifkannya.

PCEVENT_ITEM_FLAG_ONESHOT

Menunjukkan bahwa pemberitahuan peristiwa harus diaktifkan untuk kejadian berikutnya dari peristiwa ini saja. Klien tidak (dan tidak boleh) menonaktifkan peristiwa setelah terjadi.

PCEVENT_ITEM_FLAG_BASICSUPPORT

Jika klien menentukan bendera ini, driver akan mengembalikan STATUS_SUCCESS jika mendukung peristiwa dan kode kesalahan jika tidak.

Handler

Arahkan ke rutinitas penanganan aktivitas driver miniport. Anggota ini adalah penunjuk fungsi jenis PCPFNEVENT_HANDLER, yang didefinisikan sebagai berikut:

  typedef NTSTATUS (*PCPFNEVENT_HANDLER)
  (
      IN PPCEVENT_REQUEST  EventRequest
  );

Saat memanggil rutinitas Handler , pemanggil meneruskan parameter panggilan tunggal, yang merupakan penunjuk ke struktur PCEVENT_REQUEST yang dialokasikan penelepon.

Keterangan

Struktur PCEVENT_ITEM menentukan item peristiwa tertentu dalam tabel otomatisasi. Struktur PCAUTOMATION_TABLE menunjuk ke array struktur PCEVENT_ITEM .

Dalam audio WDM, target untuk permintaan peristiwa adalah instans pin atau simpul pada pin. Instans filter tidak dapat menjadi target permintaan peristiwa.

Persyaratan

Persyaratan	Nilai
Header	portcls.h (termasuk Portcls.h)

Lihat juga

PCAUTOMATION_TABLE

PCEVENT_REQUEST