EVT_ACX_FACTORY_CIRCUIT_POWER_UP fonction de rappel (acxcircuit.h)

  • Article

Le rappel EVT_ACX_FACTORY_CIRCUIT_POWER_UP est utilisé par le pilote pour ajouter des fonctionnalités dans le chemin d’accès de mise sous tension d’un objet ACXFACTORYCIRCUIT.

Syntaxe

EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;

NTSTATUS EvtAcxFactoryCircuitPowerUp(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDF_POWER_DEVICE_STATE PreviousState
)
{...}

Paramètres

Device

Objet WDFDEVICE (décrit dans Summary of Framework Objects) associé au circuit ACX.

Factory

Objet ACXFACTORYCIRCUIT de la fabrique de circuits existante. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

PreviousState

Énumération WDF_POWER_DEVICE_STATE qui identifie l’état d’alimentation précédent de l’appareil.

Valeur retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.

Si le pilote échoue à ce rappel, il marque l’ACXFACTORYCIRCUIT comme étant en attente de suppression. L’infrastructure ACX n’échoue pas au rappel ACX EvtDeviceD0Entry souligné, ce qui permet aux acxFACTORYCIRCUITs existants en cours de fonctionnement à partir de cet appareil d’être utilisés pour créer des chemins audio de travail.

Remarques

Pour inscrire une fonction de rappel EvtFactoryCircuitPowerUp, un pilote doit appeler AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks.

Si le pilote a inscrit une fonction de rappel EvtFactoryCircuitPowerUp pour un appareil, l’infrastructure appelle la fonction chaque fois que l’appareil entre dans son état de fonctionnement (D0). Un appareil passe à l’état D0 lorsque l’un des éléments suivants se produit :

  • Un appareil est énuméré (car l’appareil a été branché ou le système a été redémarré).
  • Le système et tous ses appareils retournent à leur état de fonctionnement à partir d’un état de faible consommation.
  • L’appareil revient à son état de fonctionnement après son entrée dans un état de faible consommation d’énergie, car il était inactif (si l’appareil prend en charge l’inactivité à faible consommation d’énergie).
  • Le gestionnaire de Plug-and-Play a redistribué les ressources matérielles du système entre les appareils du système.
  • Le framework appelle la fonction de rappel EvtDeviceD0Entry immédiatement après que l’appareil est entré dans son état de fonctionnement (D0) et est disponible pour le pilote, mais avant que les interruptions de l’appareil aient été activées. Le paramètre PreviousState identifie l’état d’alimentation de l’appareil dans lequel se trouvait l’appareil avant son entrée dans l’état D0. Lorsque l’infrastructure appelle EvtDeviceD0Entry pour la première fois, elle fournit une valeur PreviousState de WdfPowerDeviceD3Final.

Cette fonction de rappel doit effectuer toutes les opérations nécessaires pour rendre l’appareil entièrement opérationnel.

Pour plus d’informations sur les pilotes qui fournissent cette fonction de rappel, consultez Prise en charge du PnP et de la gestion de l’alimentation dans le pilote de fonction.

La fonction de rappel EvtFactoryCircuitPowerUp est appelée dans IRQL = PASSIVE_LEVEL. Vous ne devez pas rendre cette fonction de rappel paginable.

Configuration requise pour ACX

Version ACX minimale : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxcircuit.h
IRQL PASSIVE_LEVEL

Voir aussi