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_SUCCESS | 此函式已順利完成。 使用 returnValue 中所傳回的值,判斷是否已從佇列中移除 Dpc。 |
言論
如果指定的 StorPort DPC 位於 DPC 佇列中,StorPortCancelDpc 從佇列中移除它,取消對相關聯 DPC 例程的呼叫。 如果它不在佇列中,表示它正在執行或已完成執行,因此無法移除。
此例程是使用內嵌函式定義來實作,因此使用該例程的迷你埠驅動程式不需要連結到相依於作系統版本的連結庫。 迷你埠驅動程式可以使用此例程,而不犧牲與記憶體迷你埠驅動程式中不支援 DPC 的作系統版本回溯相容性。
要求
要求 | 價值 |
---|---|
標頭 | storport.h |