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

Voir aussi

EvtDevicePrepareHardware

EvtDeviceReleaseHardware

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT