HW_EVENT_DESCRIPTOR 구조체(strmini.h)

클래스 드라이버가 미니 드라이버의 StrMiniEvent 루틴 중 하나를 호출하면 HW_EVENT_DESCRIPTOR 구조체에 대한 포인터를 전달하여 이벤트를 사용하거나 사용하지 않도록 설정합니다.

통사론

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;

회원

Enable

활성화된 이벤트에 대해 TRUE 사용 안 함 이벤트에 대해 FALSE 설정됩니다.

EventEntry

이 이벤트를 설명하는 KSEVENT_ENTRY 구조를 가리킵니다.

EventData

이 이벤트 인스턴스를 설명하는 KSEVENTDATA 구조를 가리킵니다.

StreamObject

클래스 드라이버가 사용/사용하지 않도록 설정하는 이벤트를 소유하는 스트림의 HW_STREAM_OBJECT 가리키거나, 이벤트가 드라이버 전체에 속하는 경우 NULL .

DeviceExtension

미니 드라이버의 디바이스 확장을 가리킵니다.

EnableEventSetIndex

스트림 이벤트의 경우 스트림 HW_STREAM_INFORMATION 구조의 StreamEventsArray 멤버 내에 설정된 이벤트 집합의 인덱스를 지정합니다.

디바이스 이벤트의 경우 미니 드라이버 HW_STREAM_HEADER 구조의 DeviceEventsArray 멤버 내에 설정된 이벤트의 인덱스를 지정합니다.

HwInstanceExtension

미니 드라이버의 인스턴스 확장에 대한 포인터입니다. 미니 드라이버는 이 버퍼를 사용하여 이 미니 드라이버 인스턴스에 전역 개인 정보를 기록할 수 있습니다. 미니 드라이버는 StreamClassRegisterMinidriver통해 자신을 등록할 때 통과하는 HW_INITIALIZATION_DATA 구조에서 이 버퍼의 크기를 설정합니다.

Reserved

시스템 사용을 위해 예약되어 있습니다. 사용하지 마세요.

Reserved[2]

시스템 사용을 위해 예약되어 있습니다. 사용하지 마세요.

요구 사항

요구	값
헤더	strmini.h(Strmini.h 포함)