Freigeben über

HW_EVENT_DESCRIPTOR Struktur (strmini.h)

  • Artikel

Wenn der Klassentreiber eine der StrMiniEvent-Routinen des Minidrivers 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;

Angehörige

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 diese Instanz des Ereignisses beschreibt.

StreamObject

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

DeviceExtension

Verweist auf die Geräteerweiterung des Minidrivers.

EnableEventSetIndex

Bei Streamereignissen gibt dies den Index des Ereignisses in der StreamEventsArray Member der HW_STREAM_INFORMATION Struktur des Datenstroms an.

Bei Geräteereignissen gibt dies den Index des Ereignisses innerhalb des DeviceEventsArray Member der HW_STREAM_HEADER Struktur des Minidrivers an.

HwInstanceExtension

Zeiger auf die Instanzerweiterung des Minidrivers. Der Minidriver kann diesen Puffer verwenden, um private Informationen global für diese Instanz 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 StreamClassRegisterMinidriverregistriert.

Reserved

Reserviert für die Systemverwendung. Nicht verwenden.

Reserved[2]

Reserviert für die Systemverwendung. Nicht verwenden.

Anforderungen

Anforderung Wert
Header- strmini.h (einschließlich Strmini.h)