StorPortCancelDpc 函数 (storport.h)

StorPortCancelDpc 尝试取消 StorPort 延迟过程调用 (DPC) 的执行。

语法

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

HwDeviceExtension

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

Dpc

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

ReturnValue

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

返回值	说明
TRUE	指定的 Dpc 已成功从系统的 DPC 队列中删除。
FALSE	指定的 Dpc 未从系统的 DPC 队列中删除。

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

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

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

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

要求	值
Header	storport.h