WUDF_INTERRUPT_ENABLE fonction de rappel (wudfinterrupt.h)

La fonction de rappel d’événement OnInterruptEnable d’un pilote active une interruption matérielle spécifiée.

Syntaxe

WUDF_INTERRUPT_ENABLE WudfInterruptEnable;

HRESULT WudfInterruptEnable(
  [in] IWDFInterrupt *Interrupt,
  [in] IWDFDevice *AssociatedDevice
)
{...}

Paramètres

[in] Interrupt

Pointeur vers l’interface IWDFInterrupt .

[in] AssociatedDevice

Pointeur vers l’interface IWDFDevice que le pilote a utilisé pour appeler CreateInterrupt.

Valeur retournée

La fonction de rappel doit retourner S_OK si l’opération réussit. Sinon, le rappel doit retourner l’un des codes d’erreur définis dans Winerror.h.

Remarques

Pour inscrire une fonction de rappel OnInterruptEnable , votre pilote doit placer l’adresse de la fonction de rappel dans une structure WUDF_INTERRUPT_CONFIG avant d’appeler IWDFDevice ::CreateInterrupt.

L’infrastructure appelle la fonction de rappel OnInterruptEnable du pilote chaque fois que l’appareil entre dans son état de travail (D0). En outre, un pilote peut amener l’infrastructure à appeler la fonction de rappel OnInterruptEnable en appelant IWDFInterrupt ::Enable.

Avant d’appeler la fonction de rappel OnInterruptEnable , l’infrastructure acquiert le verrou d’interruption en mode utilisateur.

Après avoir appelé la fonction de rappel OnInterruptEnable , l’infrastructure appelle la fonction de rappel d’événement OnD0EntryPostInterruptsEnabled du pilote.

Pour plus d’informations sur la gestion des interruptions dans les pilotes UMDF, consultez Accès au matériel et Gestion des interruptions.

Exemples

Le type de fonction est déclaré dans Wudfinterrupt.h, comme suit.

typedef
__drv_functionClass(WUDF_INTERRUPT_ENABLE)
HRESULT
WUDF_INTERRUPT_ENABLE(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFDevice* AssociatedDevice
    );

typedef WUDF_INTERRUPT_ENABLE *PFN_WUDF_INTERRUPT_ENABLE;

Pour définir une fonction de rappel OnInterruptEnable nommée MyInterruptEnable, vous devez d’abord fournir une déclaration de fonction requise par SDV et d’autres outils de vérification, comme suit :

WUDF_INTERRUPT_ENABLE  MyInterruptEnable;

Ensuite, implémentez votre fonction de rappel comme suit :

HRESULT
  MyInterruptEnable (
    IN IWDFInterrupt* pInterrupt,
    IN IWDFDevice*  pAssociatedDevice
    )
  {…}

Configuration requise

Voir aussi

• IWDFDevice ::CreateInterrupt
• OnInterruptDisable
• WUDF_INTERRUPT_CONFIG