StorPortCancelDpc 函数（storport.h）

StorPortCancelDpc 尝试取消执行 StorPort 延迟过程调用（DPC）。

语法

ULONG StorPortCancelDpc(
  PVOID     HwDeviceExtension,
  PSTOR_DPC Dpc,
  BOOLEAN   *ReturnValue
);

HwDeviceExtension

指向主机总线适配器（HBA）的硬件设备扩展的指针。

Dpc

指向要取消的 STOR_DPC DPC 对象的指针。

ReturnValue

指向 BOOLEAN 的指针，此函数将返回以下值之一。

返回值	描述
真	指定的 Dpc 已成功从系统的 DPC 队列中删除。
假	指定的 Dpc 未从系统的 DPC 队列中删除。

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

返回代码	描述
STOR_STATUS_INVALID_PARAMETER	Dpc 或 ReturnValue 为 NULL。
STOR_STATUS_NOT_IMPLEMENTED	此函数未在活动作系统上实现。
STOR_STATUS_SUCCESS	此函数成功完成。使用 ReturnValue 中返回的值来确定是否从队列中删除了 Dpc。

如果指定的 StorPort DPC 位于 DPC 队列中，StorPortCancelDpc 将其从队列中删除，从而取消对关联的 DPC 例程的调用。如果它不在队列中，则执行或已完成执行，因此无法删除。

此例程是使用内联函数定义实现的，因此使用该例程的微型端口驱动程序不必链接到依赖于作系统版本的库。微型端口驱动程序可以使用此例程，而不会牺牲与不支持存储微型端口驱动程序中 DPC 的作系统版本向后兼容。

要求	价值
标头	storport.h