共用方式為

RxPostToWorkerThread 函式 （rxworkq.h）

  • 發行項

RxPostToWorkerThread 會叫用在背景工作線程內容中做為參數傳遞的例程。 呼叫端必須配置WORK_QUEUE_ITEM的記憶體。

語法

NTSTATUS RxPostToWorkerThread(
  [in] IN PRDBSS_DEVICE_OBJECT     pMRxDeviceObject,
  [in] IN WORK_QUEUE_TYPE          WorkQueueType,
  [in] IN PRX_WORK_QUEUE_ITEM      pWorkQueueItem,
  [in] IN PRX_WORKERTHREAD_ROUTINE Routine,
  [in] IN PVOID                    pContext
);

參數

[in] pMRxDeviceObject

對應網路迷你重新導向器驅動程式之裝置物件的指標。

[in] WorkQueueType

代表工作優先順序的工作佇列類型。 此參數可以是下列其中一個值：

CriticalWorkQueue

將WORK_QUEUE_ITEM插入佇列中，系統線程具有即時優先權屬性會處理工作專案。

DelayedWorkQueue

將WORK_QUEUE_ITEM插入佇列中，其中具有變數優先順序屬性的系統線程將處理工作專案。

HyperCriticalWorkQueue

將WORK_QUEUE_ITEM插入佇列中，系統線程將處理工作專案，以免封鎖要叫用的例程。

[in] pWorkQueueItem

WORK_QUEUE_ITEM的指標。

[in] Routine

要叫用之例程的指標。

[in] pContext

與工作專案相關聯的內容參數指標，以完成傳遞至驅動程式。

傳回值

RxDispatchToWorkerThread 會在成功時傳回STATUS_SUCCESS，或失敗時傳回下列其中一個錯誤碼：

傳回碼 描述
STATUS_INSUFFICIENT_RESOURCES
 無法分派專案。

言論

將作業分派至背景工作線程有兩個常見案例。 下列兩個分派作業之間的取捨是時間與空間（記憶體使用量）：

  • 當作業要重複分派時，會將WORK_QUEUE_ITEM結構預先配置為要分派的數據結構一部分，以節省時間。 在此情況下，請使用 RxPostToWorkerThread 例程。
  • 針對不常執行的作業，您可以視需要動態配置和釋放工作佇列專案的記憶體來節省空間。 在此情況下，請使用 RxDispatchToWorkerThread 例程。
RxPostToWorkerThread 例程會叫用背景工作線程內容中的例程。 呼叫例程必須從非分頁集區內存配置WORK_QUEUE_ITEM結構的記憶體。

RxPostToWorkerThread 的目前實作，例程佇列會處理呼叫來源的相同處理器。

如果偵錯組建上的 RxPostToWorkerThread 例程失敗，則會呼叫 _RxLog 例程，並包含錯誤的詳細數據。 如果 RxPostToWorkerThread 例程失敗，且已在核心中啟用 WMI，則會使用 WMI 記錄錯誤的詳細數據。

要求

要求 價值
目標平臺 桌面
標頭 rxworkq.h （包括 Rxworkq.h、Rxstruc.h、Ntifs.h）
IRQL <= APC_LEVEL

另請參閱

RxDispatchToWorkerThread

RxSpinDownMRxDispatcher

_RxLog