_HW_EVENT_DESCRIPTOR structure

When the class driver calls one of the minidriver's StrMiniEvent routines, it passes a pointer to an HW_EVENT_DESCRIPTOR structure to describe the event as enabled or disabled.

Syntax

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

Members

Enable

This is set to TRUE for an enabled event, and FALSE for a disabled event.

EventEntry

Points to the KSEVENT_ENTRY structure that describes this event.

EventData

Points to the KSEVENTDATA structure that describes this instance of the event.

EnableEventSetIndex

For stream events, this specifies the index of the event set within the StreamEventsArray member of the stream's HW_STREAM_INFORMATION structure.

For device events, this specifies the index of the event set within the DeviceEventsArray member of the minidriver's HW_STREAM_HEADER structure.

HwInstanceExtension

Pointer to the minidriver's instance extension. The minidriver may use this buffer to record private information global to this instance of the minidriver. The minidriver sets the size of this buffer in the HW_INITIALIZATION_DATA structure it passes when it registers itself via StreamClassRegisterMinidriver.

Requirements

   
Header strmini.h (include Strmini.h)