IO_WORKITEM_ROUTINE_EX回呼函式 (wdm.h)

發行項
02/29/2024

WorkItemEx 例程會執行由 IoQueueWorkItemEx 或 IoTryQueueWorkItem 例程排入佇列的工作項目處理。

語法

IO_WORKITEM_ROUTINE_EX IoWorkitemRoutineEx;

void IoWorkitemRoutineEx(
  [in]           PVOID IoObject,
  [in, optional] PVOID Context,
  [in]           PIO_WORKITEM IoWorkItem
)
{...}

參數

[in] IoObject

呼叫端驅動程式物件的指標或呼叫端的其中一個裝置物件。這是在配置工作專案時以 DeviceObject 參數的形式傳遞至 IoAllocateWorkItem 的指標，或當做 IoInitializeWorkItem 或 IoTryQueueWorkItem 初始化時傳遞至 IoAllocateWorkItem 的指標。

[in, optional] Context

指定驅動程式特定的內容資訊。這是當工作專案排入佇列時，當做 Context 參數傳遞至 IoQueueWorkItemEx 或 IoTryQueueWorkItem 的值。

[in] IoWorkItem

工作專案之IO_WORKITEM 結構的指標。這是當做 IoWorkItem 參數傳遞至 IoQueueWorkItemEx 或 IoTryQueueWorkItem的指標。

傳回值

無

備註

驅動程式只能在 Windows Vista 和更新版本的 Windows 上實作 WorkItemEx 例程。

驅動程式會呼叫IoQueueWorkItemEx或IoTryQueueWorkItem來排入 WorkItemEx 例程，而系統背景工作線程接著會執行例程。如需詳細資訊，請參閱系統背景工作線程。

WorkItemEx 例程必須執行一段時間有限;否則，系統可能會死結。如需詳細資訊，請參閱系統背景工作線程。

WorkItemEx 例程會在 IRQL = PASSIVE_LEVEL以及在系統線程內容中執行。

範例

若要定義 WorkItemEx 回呼例程，您必須先提供函式宣告，以識別您要定義的回呼例程類型。 Windows 提供一組驅動程式的回呼函式類型。使用回呼函式類型宣告函式有助於驅動程式的程式代碼分析、靜態驅動程式驗證器 (SDV) ，以及其他驗證工具會尋找錯誤，而且這是撰寫 Windows 操作系統驅動程式的需求。

例如，若要定義名為MyWorkItemEx的 WorkItemEx 回呼例程，請使用 IO_WORKITEM_ROUTINE_EX 類型，如下列程式代碼範例所示：

IO_WORKITEM_ROUTINE_EX MyWorkItemEx;

然後，實作回呼例程，如下所示：

_Use_decl_annotations_
VOID
  MyWorkItemEx(
    PVOID  IoObject,
    PVOID  Context,
    PIO_WORKITEM  IoWorkItem 
    )
  {
      // Function body
  }

IO_WORKITEM_ROUTINE_EX函式類型定義於 Wdm.h 頭檔中。若要在執行程式代碼分析工具時更精確地識別錯誤，請務必將 _Use_decl_annotations_ 註釋新增至函式定義。批 _Use_decl_annotations_ 注可確保在頭檔中套用至IO_WORKITEM_ROUTINE_EX函式類型的批註。如需函式宣告需求的詳細資訊，請參閱使用WDM驅動程式的函式角色類型來宣告函式。如需的相關信息 _Use_decl_annotations_，請參閱標註函式行為。