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_BLOCKHW_STREAM_OBJECT、HW_TIME_CONTEXTHwDeviceExtension 成员中的缓冲区,并将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 (请参阅参数部分)