WdfInterruptGetInfo, fonction (wdfinterrupt.h)
[S’applique à KMDF et UMDF]
La méthode WdfInterruptGetInfo récupère des informations sur une interruption spécifiée.
Syntaxe
void WdfInterruptGetInfo(
[in] WDFINTERRUPT Interrupt,
[in, out] PWDF_INTERRUPT_INFO Info
);
Paramètres
[in] Interrupt
Handle de l’objet d’interruption.
[in, out] Info
Pointeur vers une structure de WDF_INTERRUPT_INFO allouée par l’appelant qui a été initialisée en appelant WDF_INTERRUPT_INFO_INIT.
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
La méthode WdfInterruptGetInfo peut obtenir des informations d’interruption uniquement si votre pilote l’appelle après que l’infrastructure a appelé la fonction de rappel EvtDevicePrepareHardware du pilote et avant que l’infrastructure ait appelé la fonction de rappel EvtDeviceReleaseHardware du pilote.
Une fois WdfInterruptGetInfo retourné, le pilote peut identifier les objets d’interruption de niveau passif en examinant le membre Irql de la structure WDF_INTERRUPT_INFO . Pour les objets d’interruption de niveau passif, cette valeur est PASSIVE_LEVEL.
Pour plus d’informations sur l’ordre dans lequel les fonctions de rappel d’un pilote sont appelées, consultez Scénarios pnP et de gestion de l’alimentation.
Pour plus d’informations sur la gestion des interruptions dans les pilotes basés sur l’infrastructure, consultez Gestion des interruptions matérielles.
Exemples
L’exemple de code suivant initialise une structure WDF_INTERRUPT_INFO et appelle WdfInterruptGetInfo.
WDF_INTERRUPT_INFO Info;
WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
Interrupt,
&Info
);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfinterrupt.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf) |