RxPostToWorkerThread, fonction (rxworkq.h)

Article
02/07/2025

RxPostToWorkerThread appelle une routine passée en tant que paramètre dans le contexte d’un thread de travail. La mémoire du WORK_QUEUE_ITEM doit être allouée par l’appelant.

Syntaxe

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
);

Paramètres

[in] pMRxDeviceObject

Pointeur vers l’objet de périphérique du pilote de mini-redirecteur réseau correspondant.

[in] WorkQueueType

Type de la file d’attente de travail qui représente la priorité de la tâche. Ce paramètre peut être l’une des valeurs suivantes :

CriticalWorkQueue

Insérez WORK_QUEUE_ITEM dans la file d’attente à partir de laquelle un thread système avec un attribut de priorité en temps réel traite l’élément de travail.

DelayedWorkQueue

Insérez WORK_QUEUE_ITEM dans la file d’attente à partir de laquelle un thread système avec un attribut de priorité variable traite l’élément de travail.

HyperCriticalWorkQueue

Insérez WORK_QUEUE_ITEM dans la file d’attente à partir de laquelle un thread système traite l’élément de travail afin que la routine à appeler ne soit pas bloquée.

[in] pWorkQueueItem

Pointeur vers WORK_QUEUE_ITEM.

[in] Routine

Pointeur vers la routine à appeler.

[in] pContext

Pointeur vers un paramètre de contexte associé à l’élément de travail à terminer qui est transmis au pilote.

Valeur de retour

RxDispatchToWorkerThread retourne STATUS_SUCCESS en cas de réussite ou l’un des codes d’erreur suivants en cas d’échec :

Retourner le code	Description
STATUS_INSUFFICIENT_RESOURCES	Impossible de distribuer l’élément.

Remarques

Il existe deux cas courants de répartition d’opérations vers des threads de travail. Le compromis entre les deux opérations de répartition suivantes est le temps et l’espace (utilisation de la mémoire) :

Lorsqu’une opération va être distribuée à plusieurs reprises, le temps est conservé en allouant à l’avance la structure WORK_QUEUE_ITEM dans le cadre de la structure de données à distribuer. Dans ce cas, utilisez la routine RxPostToWorkerThread.
Pour une opération peu fréquente, vous pouvez conserver de l’espace en allouant et en libérant dynamiquement de la mémoire pour l’élément de file d’attente de travail quand il est nécessaire. Dans ce cas, utilisez la routine RxDispatchToWorkerThread.

La routine RxPostToWorkerThread appelle une routine dans le contexte d’un thread de travail. La mémoire de la structure WORK_QUEUE_ITEM doit être allouée à partir de la mémoire de pool non paginée par la routine appelante.

L’implémentation actuelle de l'RxPostToWorkerThread files d’attente de routine fonctionne sur le même processeur à partir duquel l’appel provient.

Si la routine RxPostToWorkerThread échoue sur une build de débogage, la routine _RxLog est appelée avec des détails de l’erreur. Si la routine RxPostToWorkerTh read échoue et que WMI est activé dans le noyau, les détails de l’erreur sont consignés avec WMI.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	rxworkq.h (include Rxworkq.h, Rxstruc.h, Ntifs.h)
IRQL	<= APC_LEVEL

Voir aussi

RxDispatchToWorkerThread

RxSpinDownMRxDispatcher

_RxLog

Partager via