storPortIssueDpc 函式 (storport.h)

發行項
02/29/2024

StorPortIssueDpc 例程會發出延遲過程調用 (DPC) 。

語法

BOOLEAN StorPortIssueDpc(
  [in] PVOID     DeviceExtension,
  [in] PSTOR_DPC Dpc,
  [in] PVOID     SystemArgument1,
  [in] PVOID     SystemArgument2
);

參數

[in] DeviceExtension

每個適配卡裝置擴充功能的指標。

[in] Dpc

緩衝區的指標，其中包含 StorPortInitializeDpc 例程所傳回之類型STOR_DPC初始化的 DPC 物件。

[in] SystemArgument1

將傳遞至延後例程之呼叫端提供資訊的指標。

[in] SystemArgument2

將傳遞至延後例程之呼叫端提供資訊的指標。

傳回值

如果成功將 DPC 插入 DPC 佇列， StorPortIssueDpc 例程會傳回 TRUE ，否則會傳回 FALSE 。

備註

StorPortIssueDpc 例程會呼叫 KeInsertQueueDpc 核心例程來將 DPC 排入佇列。 KeInsertQueueDpc 核心例程不允許將 DPC 排入佇列多次。因此，如果 Dpc 參數指定的 DPC 對象已經在 DPC 佇列中， KeInsertQueueDpc 會忽略佇列要求。這可確保以 StorPortInitializeDpc 初始化的延後例程一律會與本身同步處理。換句話說，呼叫端不需要循序呼叫 StorPortIssueDpc 例程，以確保例程不會同時執行多個實例。

如果迷你埠驅動程式有多個工作項目必須由相同的 DPC 執行，迷你埠驅動程式必須確定每個工作專案都已完成，才能發出下一個工作專案的 DPC。