IWDFInterrupt ::SetPolicy, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode SetPolicy spécifie la priorité d’interruption, l’affinité du processeur et la stratégie d’affinité pour une interruption spécifiée.
Syntaxe
void SetPolicy(
[in] WDF_INTERRUPT_POLICY Policy,
[in] WDF_INTERRUPT_PRIORITY Priority,
[in] KAFFINITY TargetProcessorSet
);
Paramètres
[in] Policy
Énumérateur WDF_INTERRUPT_POLICY-typé qui spécifie une stratégie d’affinité du processeur pour l’interruption.
[in] Priority
Énumérateur WDF_INTERRUPT_PRIORITY-typé qui spécifie une priorité pour l’interruption.
[in] TargetProcessorSet
Valeur KAFFINITY-typée qui spécifie une affinité de processeur pour l’interruption, si le paramètre Policy est défini sur WdfIrqPolicySpecifiedProcessors.
Valeur de retour
Aucun
Remarques
À compter de Windows Vista, les pilotes peuvent spécifier la priorité, l’affinité du processeur et la stratégie d’affinité d’interruption. Pour plus d’informations sur l’utilisation du Registre pour remplacer les valeurs qui ensembles de SetPolicy, consultez Affinité d’interruption etde priorité.
Si un pilote s’exécute sur une version du système d’exploitation antérieure à Windows Vista, l’infrastructure ignore les valeurs spécifiées par le pilote lorsqu’il appelle SetPolicy.
Pour plus d’informations sur les valeurs de Registre et les sections INF qui spécifient la priorité, l’affinité processeur et la stratégie d’affinité d’interruption, consultez Affinité d’interruption et.
Si un pilote appelle SetPolicy, il doit le faire dans son IDriverEntry ::OnDeviceAdd fonction de rappel, après avoir appelé la méthode IWDFDevice3 ::CreateInterrupt.
Pour plus d’informations sur la gestion des interruptions dans les pilotes UMDF, consultez Accès aux interruptions matérielles et de gestion des interruptions.
Exemples
L’exemple de code suivant affecte une interruption d’appareil au processeur 0, avec une priorité normale.
#define AFFINITY_MASK(n) ((ULONG_PTR)1 << (n))
pIWdfInterrupt->SetPolicy(
WdfIrqPolicySpecifiedProcessors,
WdfIrqPriorityNormal,
AFFINITY_MASK(0)
);
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.11 |
| d’en-tête | wudfddi.h |
| DLL | WUDFx.dll |