Функция StreamClassGetNextEvent (strmini.h)

Статья
02/07/2025

Мини-drivers могут использовать процедуру 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. Мини-driver задает размер этого буфера в структуре HW_INITIALIZATION_DATA, которая передается при регистрации через StreamClassRegisterMinidriver. Затем драйвер класса передает указатели на буфер в HwDeviceExtension член HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTи PORT_CONFIGURATION_INFORMATION структурирует его в мини-driver.

Этот первый параметр был PVOID HwDeviceExtension. Он должен быть HwInstanceExtension для драйверов с несколькими экземплярами и несколькими фильтрами (версия 20). Устаревшие драйверы одного экземпляра могут продолжать указывать HwDeviceExtension в качестве первого параметра. Он также может указать HwInstanceExtension.

[in, optional] HwStreamObject

Указатель на HW_STREAM_OBJECT. Задайте значение NULL для поиска очереди событий самого устройства. Чтобы выполнить поиск в очереди событий определенного потока, задайте объект потока.

[in, optional] EventGuid

Указывает набор событий, соответствующий при переходе по очереди или NULL для сопоставления любого набора событий.

[in] EventItem

Указывает идентификатор события, соответствующий при переходе по очереди или -1 для сопоставления любого события.

[in, optional] CurrentEvent

Указатель на событие в очереди событий или NULL.

Возвращаемое значение

Если CurrentEvent не NULL, StreamClassGetNextEvent возвращает следующее событие сопоставления после CurrentEvent в очереди (или NULL, если такого события нет). Если CurrentEventNULL, StreamClassGetNextEvent возвращает первое событие сопоставления в очереди.

Замечания

Мини-driver может вызывать StreamClassGetNextEvent последовательно выполнять цикл по очереди событий, проверяя одно событие за раз.

Вызывающий объект может указать дополнительные критерии поиска для сопоставления событий в очереди событий.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	strmini.h (include Strmini.h)
библиотеки	Stream.lib

Поделиться через