StreamClassDeviceNotification function (strmini.h)

Article
02/22/2024

Minidrivers use the StreamClassDeviceNotification routine to notify the class driver that it has completed a stream request, or that an event has occurred.

Syntax

void StreamClassDeviceNotification(
  [in] STREAM_MINIDRIVER_DEVICE_NOTIFICATION_TYPE NotificationType,
  [in] PVOID                                      HwDeviceExtension,
       ...                                        
);

Parameters

[in] NotificationType

This is an enumeration value that contains the type of notification that the minidriver is sending.

DeviceRequestComplete

Indicates that the minidriver has completed its handling of the device stream request block. Once the minidriver calls StreamClassDeviceNotification with this value, the relevant SRB is owned by the class driver, which is free to deallocate it.

ReadyForNextDeviceRequest

Indicates that the minidriver is ready to receive another device request.

SignalDeviceEvent

Signals that the event specified by an optional parameter has occurred.

SignalMultipleDeviceEvents

Signals all events that match the criteria specified in optional parameters.

DeleteDeviceEvent

Deletes the event specified by an optional parameter.

[in] HwDeviceExtension

Pointer to the minidriver's device extension. The minidriver specifies the size of this buffer in the HW_INITIALIZATION_DATA structure it passes when it registers itself via StreamClassRegisterMinidriver. The class driver then passes pointers to the buffer in the HwDeviceExtension member of the HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXT, and PORT_CONFIGURATION_INFORMATION structures it passes to the minidriver.

...

Return value

None

Remarks

The minidriver uses this routine for requests or events that apply to the minidriver as a whole. Stream-specific requests or events use StreamClassStreamNotification.

Requirements

Requirement	Value
Target Platform	Desktop
Header	strmini.h (include Strmini.h)
Library	Stream.lib