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 WDF_INTERRUPT_INFO allouée par l’appelant qui a été initialisée en appelant WDF_INTERRUPT_INFO_INIT.
Valeur de retour
Aucun
Remarques
Une vérification de bogue 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 une fois que l’infrastructure a appelé le EvtDevicePrepareHardware fonction de rappel et avant que l’infrastructure n’ait appelé la fonction de rappel EvtDeviceReleaseHardware du pilote fonction de rappel.
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 Power Management.
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
);
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| En-tête | wdfinterrupt.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf) |