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

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

StreamObject

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

DeviceExtension

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

EnableEventSetIndex

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

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

HwInstanceExtension

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

Reserved

시스템에서 사용하도록 예약되었습니다. 사용하지 마십시오.

Reserved[2]

시스템에서 사용하도록 예약되었습니다. 사용하지 마십시오.

요구 사항

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