RxPostToWorkerThread 函式 (rxworkq.h)

發行項
02/29/2024

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，或在失敗時傳回下列其中一個錯誤碼：

傳回碼	Description
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

共用方式為