Функция StreamClassDeviceNotification (strmini.h)
Мини-drivers используют процедуру StreamClassDeviceNotification, чтобы уведомить драйвер класса о том, что он завершил потоковый запрос или что произошло событие.
Синтаксис
void StreamClassDeviceNotification(
[in] STREAM_MINIDRIVER_DEVICE_NOTIFICATION_TYPE NotificationType,
[in] PVOID HwDeviceExtension,
...
);
Параметры
[in] NotificationType
Это значение перечисления, содержащее тип уведомления, которое отправляет мини-driver.
DeviceRequestComplete
Указывает, что мини-driver завершил обработку блока запросов потока устройства. После вызова мини-driver StreamClassDeviceNotification с этим значением соответствующий SRB принадлежит драйверу класса, который является бесплатным для его освобождения.
ReadyForNextDeviceRequest
Указывает, что мини-driver готов к получению другого запроса устройства.
SignalDeviceEvent
Сигнализирует о том, что событие, указанное необязательным параметром, произошло.
SignalMultipleDeviceEvents
Сигнализирует обо всех событиях, которые соответствуют критериям, указанным в необязательных параметрах.
DeleteDeviceEvent
Удаляет событие, указанное необязательным параметром.
[in] HwDeviceExtension
Указатель на расширение устройства minidriver. Мини-driver задает размер этого буфера в структуре HW_INITIALIZATION_DATA, которая передается при регистрации через StreamClassRegisterMinidriver. Затем драйвер класса передает указатели на буфер в HwDeviceExtension член HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTи PORT_CONFIGURATION_INFORMATION структурирует его в мини-driver.
...
Возвращаемое значение
Никакой
Замечания
Мини-driver использует эту подпрограмму для запросов или событий, которые применяются к мини-driver в целом. Запросы или события, относящиеся к потоку, используют StreamClassStreamNotification.
Требования
Требование | Ценность |
---|---|
целевая платформа | Настольный |
заголовка | strmini.h (include Strmini.h) |
библиотеки | Stream.lib |