EVT_ACX_FACTORY_CIRCUIT_POWER_UP funzione di callback (acxcircuit.h)
Il callback EVT_ACX_FACTORY_CIRCUIT_POWER_UP viene usato dal driver per aggiungere funzionalità nel percorso di alimentazione di un oggetto ACXFACTORYCIRCUIT.
Sintassi
EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;
NTSTATUS EvtAcxFactoryCircuitPowerUp(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory,
WDF_POWER_DEVICE_STATE PreviousState
)
{...}
Parametri
Device
Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti framework) associato al circuito ACX.
Factory
Oggetto ACXFACTORYCIRCUIT della factory del circuito esistente. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
PreviousState
Un'enumerazione WDF_POWER_DEVICE_STATE che identifica lo stato di alimentazione del dispositivo precedente.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso di valori NTSTATUS.
Se il driver non riesce, contrassegna ACXFACTORYCIRCUIT come eliminazione in sospeso. Il framework ACX non ha esito negativo con il callback ACX EvtDeviceD0Entry, in modo da consentire l'uso di ACXFACTORYCIRCUITs esistenti da questo dispositivo per creare percorsi audio funzionanti.
Osservazioni
Per registrare una funzione di callback EvtFactoryCircuitPowerUp, un driver deve chiamare AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks.
Se il driver ha registrato una funzione di callback EvtFactoryCircuitPowerUp per un dispositivo, il framework chiama la funzione ogni volta che il dispositivo entra nello stato di lavoro (D0). Un dispositivo entra nello stato D0 quando si verifica uno dei seguenti:
- Un dispositivo viene enumerato (perché il dispositivo è stato collegato o il sistema è stato riavviato).
- Il sistema e tutti i suoi dispositivi tornano agli stati di lavoro da uno stato a basso consumo.
- Il dispositivo torna allo stato di funzionamento dopo che è entrato in uno stato a basso consumo perché era inattivo (se il dispositivo supporta l'inattività a basso consumo).
- Il gestore Plug and Play ha ridistribuito le risorse hardware del sistema tra i dispositivi del sistema.
- Il framework chiama la funzione di callback EvtDeviceD0Entry immediatamente dopo che il dispositivo entra nello stato di lavoro (D0) ed è disponibile per il driver, ma prima che gli interrupt del dispositivo siano stati abilitati. Il parametro PreviousState identifica lo stato di alimentazione del dispositivo in cui si trovava il dispositivo prima che entrasse nello stato D0. Quando il framework chiama per la prima volta EvtDeviceD0Entry, fornisce un valore PreviousState di WdfPowerDeviceD3Final.
Questa funzione di callback deve eseguire tutte le operazioni necessarie per rendere il dispositivo completamente operativo.
Per altre informazioni sui driver che forniscono questa funzione di callback, vedere Supporto di PnP e risparmio energia in Driver di funzione.
La funzione di callback EvtFactoryCircuitPowerUp viene chiamata in IRQL = PASSIVE_LEVEL. Non è consigliabile rendere pageable questa funzione di callback.
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |