NdisQueueIoWorkItem, fonction (ndis.h)

Article
08/07/2023

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 à une structure de IO_WORKITEM privée qui a été retournée par un appel précédent à Fonction NdisAllocateIoWorkItem .

[in] Routine

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

Note Vous devez déclarer la fonction à l’aide du type NDIS_IO_WORKITEM_FUNCTION (et non NDIS_IO_WORKITEM_ROUTINE). Pour plus d’informations, consultez la section Exemples suivante.

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

WorkItemContext

Pointeur vers la zone de contexte que le pilote a passée au paramètre WorkItemContext de NdisQueueIoWorkItem.

NdisIoWorkItemHandle

Handle d’une structure de NDIS_IO_WORKITEM privée qui a été retournée par un appel précédent à Fonction NdisAllocateIoWorkItem .

[in] WorkItemContext

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

Valeur de retour

None

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é à l’élément de travail.

Exemples

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 fonction permet à l’analyse du code pour les pilotes, au vérificateur de pilotes statiques (SDV) et à d’autres outils de vérification de trouver des erreurs. Il s’agit d’une exigence pour l’écriture de 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 lors de l’exécution des 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 Annotating Function Behavior.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible	Universal
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis)