StreamClassGetNextEvent 함수(strmini.h)

미니 드라이버는 StreamClassGetNextEvent 루틴을 사용하여 디바이스 또는 특정 스트림의 이벤트 큐를 검색할 수 있습니다.

구문

PKSEVENT_ENTRY StreamClassGetNextEvent(
  [in, optional] PVOID             HwInstanceExtension_OR_HwDeviceExtension,
  [in, optional] PHW_STREAM_OBJECT HwStreamObject,
  [in, optional] GUID              *EventGuid,
  [in]           ULONG             EventItem,
  [in, optional] PKSEVENT_ENTRY    CurrentEvent
);

매개 변수

[in, optional] HwInstanceExtension_OR_HwDeviceExtension

미니 드라이버의 디바이스 확장에 대한 포인터입니다. minidriver는 StreamClassRegisterMinidriver를 통해 자신을 등록할 때 통과하는 HW_INITIALIZATION_DATA 구조에서 이 버퍼의 크기를 지정합니다. 그런 다음 클래스 드라이버는 미니 드라이버에 전달하는 HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXT및PORT_CONFIGURATION_INFORMATION 구조체의 HwDeviceExtension 멤버에 있는 버퍼에 포인터를 전달합니다.

이 첫 번째 매개 변수는 PVOID HwDeviceExtension이었습니다. 다중 instance 및 다중 필터 형식(버전 20) 드라이버의 경우 HwInstanceExtension이어야 합니다. 레거시 단일 instance 드라이버는 HwDeviceExtension을 첫 번째 매개 변수로 계속 지정할 수 있습니다. HwInstanceExtension을 지정할 수도 있습니다.

[in, optional] HwStreamObject

HW_STREAM_OBJECT 대한 포인터입니다. 디바이스 자체의 이벤트 큐를 검색하려면 NULL 로 설정합니다. 특정 스트림의 이벤트 큐를 검색하려면 스트림의 스트림 개체로 설정합니다.

[in, optional] EventGuid

큐를 걸을 때 일치하도록 이벤트 집합을 지정하거나 이벤트 집합과 일치하도록 NULL 을 지정합니다.

[in] EventItem

큐를 걸을 때 일치시킬 이벤트 ID를 지정하거나 이벤트와 일치하도록 -1을 지정합니다.

[in, optional] CurrentEvent

이벤트 큐의 이벤트 또는 NULL에 대한 포인터입니다.

반환 값

CurrentEvent가 NULL이 아닌 경우 StreamClassGetNextEvent는 큐의 CurrentEvent 다음에 일치하는 다음 이벤트를 반환합니다(또는 다음 이벤트가 없는 경우 NULL). CurrentEvent가 NULL인 경우 StreamClassGetNextEvent는 큐에서 일치하는 첫 번째 이벤트를 반환합니다.

설명

미니 드라이버는 StreamClassGetNextEvent 를 연속적으로 호출하여 이벤트 큐를 반복하여 한 번에 하나의 이벤트를 검사할 수 있습니다.

호출자는 이벤트 큐의 이벤트와 일치하도록 추가 검색 조건을 지정할 수 있습니다.

요구 사항