HW_EVENT_DESCRIPTOR-Struktur (strmini.h)

Wenn der Klassentreiber eine der StrMiniEvent-Routinen des Minidrivers aufruft, übergibt er einen Zeiger an 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 false für ein deaktiviertes Ereignis festgelegt.

EventEntry

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

EventData

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

StreamObject

Zeigt auf den HW_STREAM_OBJECT für den Stream, der das Ereignis besitzt, das der Klassentreiber aktiviert/deaktiviert, oder AUF NULL , wenn das Ereignis zum Gesamten des Treibers gehört.

DeviceExtension

Zeigt auf die Geräteerweiterung des Minidrivers.

EnableEventSetIndex

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

Bei Geräteereignissen gibt dies den Index des Ereignissatzes innerhalb des DeviceEventsArray-Members der HW_STREAM_HEADER-Struktur des Minidrivers an.

HwInstanceExtension

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

Reserved

Ist für das System reserviert. Nicht verwenden.

Reserved[2]

Ist für das System reserviert. Nicht verwenden.

Anforderungen