EVT_ACX_FACTORY_CIRCUIT_POWER_UP fonction de rappel (acxcircuit.h)
Le rappel EVT_ACX_FACTORY_CIRCUIT_POWER_UP est utilisé par le pilote pour ajouter des fonctionnalités dans le chemin d’alimentation 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 circuit 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 de l’appareil précédent.
Valeur de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
Si le pilote échoue ce rappel, il balise ACXFACTORYCIRCUIT comme étant en attente de suppression. L’infrastructure ACX n’échoue pas le rappel ACX EvtDeviceD0Entry, ce qui permet à acXFACTORYCIRCUITs de travail existant à partir de cet appareil d’être utilisé pour générer 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 travail (D0). Un appareil entre dans l’état D0 lorsque l’une des opérations suivantes 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 à leurs états de travail à partir d’un état à faible alimentation.
- L’appareil revient à son état de fonctionnement après avoir entré un état de faible alimentation car il était inactif (si l’appareil prend en charge l’inactivité à faible alimentation).
- Le gestionnaire Plug-and-Play a redistribué les ressources matérielles du système entre les appareils du système.
- L’infrastructure appelle la fonction de rappel EvtDeviceD0Entry immédiatement après que l’appareil entre 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 l’appareil était entré avant d’entrer dans l’état D0. Lorsque l’infrastructure appelle d’abord EvtDeviceD0Entry, 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 de PnP et de gestion de l’alimentation dans le pilote de fonction.
La fonction de rappel EvtFactoryCircuitPowerUp est appelée à IRQL = PASSIVE_LEVEL. Vous ne devez pas rendre cette fonction de rappel paginable.
Configuration requise pour ACX
version minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |