NdisQueueIoWorkItem, fonction (ndis.h)

Article
02/07/2025

Les pilotes NDIS appellent la fonction NdisQueueIoWorkItem pour mettre en file d’attente un élément de travail.

Syntaxe

void NdisQueueIoWorkItem(
  [in] NDIS_HANDLE              NdisIoWorkItemHandle,
  [in] NDIS_IO_WORKITEM_ROUTINE Routine,
  [in] PVOID                    WorkItemContext
);

Paramètres

[in] NdisIoWorkItemHandle

Handle vers une structure de IO_WORKITEM privée qui a été retournée par un appel précédent au fonction NdisAllocateIoWorkItem.

[in] Routine

Point d’entrée vers la fonction que NDIS appelle pour traiter l’élément de travail. NDIS appelle cette routine dans le contexte d’un thread système.

Remarque Vous devez déclarer la fonction à l’aide du type NDIS_IO_WORKITEM_FUNCTION (pas NDIS_IO_WORKITEM_ROUTINE). Pour plus d’informations, consultez la section Exemples suivants.

La routine inclut les paramètres d’entrée suivants :

WorkItemContext

Pointeur vers la zone de contexte transmise par le pilote au paramètre WorkItemContext de NdisQueueIoWorkItem.

NdisIoWorkItemHandle

Handle vers une structure de NDIS_IO_WORKITEM privée qui a été retournée par un appel précédent au fonction NdisAllocateIoWorkItem.

[in] WorkItemContext

Pointeur vers une zone de contexte fournie par l’appelant que NDIS passe à la routine de rappel. WorkItemContext peut être des données spécifiées par l’appelant dont le pilote a besoin pour gérer l’élément de travail.

Valeur de retour

Aucun

Remarques

NdisQueueIoWorkItem appelle IoQueueWorkItem pour mettre en file d’attente un élément de travail. Les éléments de travail NDIS utilisent le type de file d’attente CriticalWorkQueue.

La routine de rappel fournie par l’appelant (NDIS_IO_WORKITEM_ROUTINE) s’exécute dans un contexte de thread système à IRQL = PASSIVE_LEVEL.

Cette routine fournie par l’appelant peut appeler la fonction NdisFreeIoWorkItem pour récupérer le stockage alloué pour l’élément de travail.

exemples de

Pour définir une fonction routine, vous devez d’abord fournir une déclaration de fonction qui identifie le type de fonction que vous définissez. Windows fournit un ensemble de types de fonctions pour les pilotes. La déclaration d’une fonction à l’aide des types de fonctions permet d'Analyse du code pour les pilotes, de vérificateur de pilotes statiques (SDV) et d’autres outils de vérification recherchent des erreurs, et il est nécessaire d’écrire des pilotes pour le système d’exploitation Windows.

Par exemple, pour définir une fonction Routine nommée « MyWorkitemRoutine », utilisez le type NDIS_IO_WORKITEM_FUNCTION comme indiqué dans cet exemple de code :

NDIS_IO_WORKITEM_FUNCTION MyWorkitemRoutine;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
VOID
 MyWorkitemRoutine(
    PVOID   WorkItemContext,
    NDIS_HANDLE  NdisIoWorkItemHandle
    )
  {...}

Le type de fonction NDIS_IO_WORKITEM_FUNCTION est défini dans le fichier d’en-tête Ndis.h. Pour identifier plus précisément les erreurs lorsque vous exécutez les outils d’analyse du code, veillez à ajouter l’annotation Use_decl_annotations à votre définition de fonction. L’annotation Use_decl_annotations garantit que les annotations appliquées au type de fonction NDIS_IO_WORKITEM_FUNCTION dans le fichier d’en-tête sont utilisées. Pour plus d’informations sur la configuration requise pour les déclarations de fonction, consultez Déclaration de fonctions à l’aide de types de rôles de fonction pour les pilotes NDIS.

Pour plus d’informations sur Use_decl_annotations, consultez annoter le comportement de la fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible	Universel
d’en-tête	ndis.h (include Ndis.h)
bibliothèque	Ndis.lib
IRQL	<= DISPATCH_LEVEL
règles de conformité DDI	Irql_Miscellaneous_Function(ndis)