KeSetTargetProcessorDpc, fonction (wdm.h)

Article
03/01/2024

La routine KeSetTargetProcessorDpc spécifie le processeur sur lequel une routine DPC sera exécutée.

Syntaxe

void KeSetTargetProcessorDpc(
  [in, out] PRKDPC Dpc,
  [in]      CCHAR  Number
);

Paramètres

[in, out] Dpc

Pointeur vers l’objet DPC de l’appelant, que KeInitializeDpc a déjà initialisé.

[in] Number

Spécifie le nombre de base zéro du processeur cible sur lequel la DPC doit être mise en file d’attente et exécutée.

Valeur de retour

None

Remarques

Sur les systèmes multiprocesseurs, chaque processeur a sa propre file d’attente DPC. La routine KeSetTargetProcessorDpc spécifie la file d’attente du processeur que le système doit utiliser lorsque le pilote appelle KeInsertQueueDpc ou IoRequestDpc pour mettre en file d’attente un DPC à exécuter ultérieurement.

À compter de Windows Vista, vous pouvez également utiliser KeSetTargetProcessorDpc pour spécifier le processeur cible pour les contrôleurs de domaine avec threads.

Un appel à KeSetTargetProcessorDpcEx qui se produit après la mise en file d’attente d’un objet DPC n’a aucun effet sur la sélection d’un processeur pour la routine DPC sur laquelle s’exécuter. Pour contrôler la sélection du processeur cible, un appel KeSetTargetProcessorDpc doit se produire avant l’appel à KeInsertQueueDpc ou IoRequestDpc qui met en file d’attente l’objet DPC.

Pour plus d’informations sur les files d’attente DPC, consultez Organisation des files d’attente DPC.

Windows 7 et versions ultérieures de Windows prennent en charge les groupes de processeurs. Les pilotes conçus pour gérer les informations sur les groupes de processeurs doivent utiliser la routine KeSetTargetProcessorDpcEx , qui spécifie un groupe de processeurs, au lieu de KeSetTargetProcessorDpc, ce qui n’est pas le cas. Toutefois, l’implémentation de KeSetTargetProcessorDpc dans Windows 7 et les versions ultérieures de Windows fournit la compatibilité pour les pilotes qui ont été écrits pour des versions antérieures de Windows, qui ne prennent pas en charge les groupes de processeurs. Dans cette implémentation, si Nombre est inférieur au nombre de processeurs logiques actifs dans le groupe 0, KeSetTargetProcessorDpc définit la cible pour la DPC sur le processeur du groupe 0 spécifié par Number. Sinon, la cible DPC ne change pas.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	N’importe quel niveau