StreamClassCallAtNewPriority 函数 (strmini.h)
StreamClassCallAtNewPriority 例程计划以不同优先级调用的例程。
语法
VOID STREAMAPI StreamClassCallAtNewPriority(
[in, optional] PHW_STREAM_OBJECT StreamObject,
[in] PVOID HwDeviceExtension,
[in] STREAM_PRIORITY Priority,
[in] PHW_PRIORITY_ROUTINE PriorityRoutine,
[in] PVOID Context
);
参数
[in, optional] StreamObject
指向指定流与例程关联的HW_STREAM_OBJECT结构的指针;如果例程与整个设备关联,则为 NULL 。 每个流只能有一个例程,设备只能有一个例程。 此参数是可选的。
[in] HwDeviceExtension
指向微型驱动程序的设备扩展的指针。 微型驱动程序在通过 StreamClassRegisterMinidriver 注册自身时传递的HW_INITIALIZATION_DATA结构中指定此缓冲区的大小。 然后,类驱动程序将指针传递到HW_STREAM_REQUEST_BLOCK、HW_STREAM_OBJECT、HW_TIME_CONTEXT的 HwDeviceExtension 成员中的缓冲区,并将PORT_CONFIGURATION_INFORMATION结构传递给微型驱动程序。
[in] Priority
指定下表中列出的值之一。
优先级 | 使用情况 |
---|---|
高 | 流类驱动程序以与微型驱动程序的 StrMiniXxx 回调相同的优先级调用例程。 除非例程必须与微型驱动程序的中断服务例程同步,否则不要使用此设置。 |
Dispatch | 流类驱动程序在 DISPATCH_LEVEL 调用例程。 如果例程完成时间少于 1 毫秒,请使用此优先级。 |
低 | 流类驱动程序在 PASSIVE_LEVEL 调用例程。 如果例程完成时间少于 1 毫秒,请使用此优先级。 |
LowToHigh | 用于允许以低优先级调用的线程返回到高优先级,以便可以调用其他流类驱动程序服务。 |
[in] PriorityRoutine
指向在指定优先级下调用的微型驱动程序提供的 StrMiniPriorityRoutine 的指针。
[in] Context
指定要传递给 PriorityRoutine 的参数。
返回值
无
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | strmini.h (包括 Strmini.h) |
Library | Stream.lib |
IRQL | (请参阅参数部分) |