HW_EVENT_DESCRIPTOR-Struktur (strmini.h)

Wenn der Klassentreiber eine der StrMiniEvent-Routinen des Minitreibers aufruft, übergibt er einen Zeiger auf eine HW_EVENT_DESCRIPTOR-Struktur, um das Ereignis als aktiviert oder deaktiviert zu beschreiben.

Syntax

typedef struct _HW_EVENT_DESCRIPTOR {
  BOOLEAN        Enable;
  PKSEVENT_ENTRY EventEntry;
  PKSEVENTDATA   EventData;
  union {
#if ...
    _HW_STREAM_OBJECT           *StreamObject;
#else
    struct _HW_STREAM_OBJECT    *StreamObject;
#endif
#if ...
    _HW_DEVICE_EXTENSION        *DeviceExtension;
#else
    struct _HW_DEVICE_EXTENSION *DeviceExtension;
#endif
  };
  ULONG          EnableEventSetIndex;
  PVOID          HwInstanceExtension;
#if ...
  ULONG          Reserved;
#else
  ULONG          Reserved[2];
#endif
} HW_EVENT_DESCRIPTOR, *PHW_EVENT_DESCRIPTOR;

Member

Enable

Dies ist für ein aktiviertes Ereignis auf TRUE und für ein deaktiviertes Ereignis auf FALSE festgelegt.

EventEntry

Verweist auf die KSEVENT_ENTRY-Struktur , die dieses Ereignis beschreibt.

EventData

Verweist auf die KSEVENTDATA-Struktur, die diese instance des Ereignisses beschreibt.

StreamObject

Verweist auf die HW_STREAM_OBJECT für den Stream, der das Ereignis besitzt, das vom Klassentreiber aktiviert/deaktiviert wird, oder AUF NULL , wenn das Ereignis zum Treiber als Ganzes gehört.

DeviceExtension

Verweist auf die Geräteerweiterung des Minitreibers.

EnableEventSetIndex

Bei Streamereignissen gibt dies den Index des Ereignissatzes innerhalb des StreamEventsArray-Elements der HW_STREAM_INFORMATION-Struktur des Streams an.

Für Geräteereignisse gibt dies den Index des Ereignissatzes innerhalb des DeviceEventsArray-Elements der HW_STREAM_HEADER-Struktur des Minidrivers an.

HwInstanceExtension

Zeiger auf die instance-Erweiterung des Minitreibers. Der Minitreiber kann diesen Puffer verwenden, um private Informationen global für diese instance des Minitreibers aufzuzeichnen. Der Minidriver legt die Größe dieses Puffers in der HW_INITIALIZATION_DATA-Struktur fest, die er bei der Registrierung über StreamClassRegisterMinidriver übergibt.

Reserved

Ist für das System reserviert. Nicht verwenden.

Reserved[2]

Ist für das System reserviert. Nicht verwenden.

Anforderungen

Anforderung	Wert
Header	strmini.h (include Strmini.h)