StorPortCancelDpc 函式 (storport.h)

StorPortCancelDpc 嘗試取消執行 StorPort 延後過程調用 (DPC) 。

語法

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

HwDeviceExtension

主機總線適配卡 (HBA) 的硬體裝置擴充功能指標。

Dpc

要取消之STOR_DPC DPC 物件的指標。

ReturnValue

布爾值的指標，此函式會傳回下列其中一個值。

傳回值	描述
TRUE	指定的 Dpc 已成功從系統的 DPC 佇列中移除。
FALSE	指定的 Dpc 未從系統的 DPC 佇列中移除。

此函式會傳回下列其中一個狀態代碼。

傳回碼	Description
STOR_STATUS_INVALID_PARAMETER	Dpc 或 ReturnValue 為 NULL。
STOR_STATUS_NOT_IMPLEMENTED	此函式不會在作用中的操作系統上實作。
STOR_STATUS_SUCCESS	此函式已順利完成。使用 ReturnValue 中傳回的值，判斷 Dpc 是否已從佇列中移除。

如果指定的 StorPort DPC 位於 DPC 佇列中， StorPortCancelDpc 會從佇列中移除它，取消對相關聯 DPC 例程的呼叫。如果它不在佇列中，它正在執行或已完成執行，因此無法移除。

此例程是使用內嵌函式定義來實作，因此使用該例程的迷你埠驅動程式不需要連結至相依於操作系統版本的連結庫。迷你埠驅動程式可以使用此例程，而不犧牲與記憶體迷你埠驅動程式中不支援 DPC 的作業系統版本回溯相容性。

需求	值
標頭	storport.h