通过

StorPortQueryDpcWatchdogInformation 函数 (storport.h)

  • 项目

StorPortQueryDpcWatchdogInformation 查询当前处理器的 DPC 监视器计时器值。

语法

ULONG StorPortQueryDpcWatchdogInformation(
  [in]  PVOID                          HwDeviceExtension,
  [out] PSTOR_DPC_WATCHDOG_INFORMATION DpcWatchdogInformation
);

参数

[in] HwDeviceExtension

指向微型端口设备扩展的指针。

[out] DpcWatchdogInformation

指向将在其中写入 DPC 监视器信息的 STOR_DPC_WATCHDOG_INFORMATION 结构的指针。

返回值

此函数返回以下状态代码之一。

返回代码 说明
STOR_STATUS_SUCCESS 已成功查询 DPC 监视器信息。
STOR_STATUS_INVALID_PARAMETER 参数无效;例如， DpcWatchdogInformation 为 NULL。
STOR_STATUS_UNSUCCESSFUL 由于其他内部系统原因而返回。

注解

微型端口可以在 IRQL=DISPATCH_LEVEL 调用 StorPortQueryDpcWatchdogInformation ，以确定在发生超时 (D) PC 延迟过程调用之前剩余的时间量。 操作系统实现 DPC 监视程序计时器，以检测单个 DPC 例程运行时间过长，或一系列排队的 DPC 例程运行时间过长。 如果启用了 DPC 超时错误，并且 DPC 例程超过单个例程的时间限制，或者一系列 DPC 例程超出聚合时间限制，则会发生DPC_WATCHDOG_VIOLATION (0x133) bug 检查。

当 DPC 在当前处理器上以 IRQL= DISPATCH_LEVEL 或更高版本运行或调用时，必须调用 StorPortQueryDpcWatchdogInformation。 否则，调用将失败并返回STOR_STATUS_UNSUCCESSFUL。

DPC 例程应仅在短时间内运行，并应将尽可能多的处理委托给工作线程。 为了避免降低系统响应能力，典型的 DPC 例程每次调用时应运行不超过 100 微秒。 有关常规信息，请参阅 编写 DPC 例程的指南。

要求

要求 值
最低受支持的服务器 Windows Server 2022
标头 storport.h
IRQL DISPATCH_LEVEL

另请参阅

STOR_DPC_WATCHDOG_INFORMATION