Metodo IPowerNotify::P owerChangeNotify (portcls.h)
Il PowerChangeNotify metodo notifica al driver miniport le modifiche nello stato di alimentazione.
Sintassi
void PowerChangeNotify(
[in] POWER_STATE PowerState
);
Parametri
[in] PowerState
Specifica lo stato di alimentazione corrente. Questo parametro è un'unione di tipo POWER_STATE. Nuovo stato di alimentazione (PowerState.DeviceState) può essere uno dei valori di enumerazione DEVICE_POWER_STATE elencati in IAdapterPowerManagement::P owerChangeState.
Valore restituito
nessuno
Osservazioni
Il driver di sistema PortCls chiama il metodo del PowerChangeNotify driver miniport per notificare le modifiche nello stato di alimentazione. Lo scopo di questa chiamata è quello di offrire al driver miniport l'opportunità di salvare qualsiasi contesto specifico dell'hardware subito prima dell'accensione o di ripristinare un contesto salvato in precedenza subito dopo l'accensione.
Il driver miniport può scrivere nei registri hardware o nella memoria su scheda durante la PowerChangeNotify chiamata. Se il sistema sta spegnendo (effettuando una transizione di stato da PowerDeviceD0), il driver di sistema PortCls chiama PowerChangeNotify prima di chiamare IAdapterPowerManagement::P owerChangeState e dopo aver sospeso tutti i flussi di dati audio attivi. In questo modo il driver miniport offre la possibilità di salvare qualsiasi contesto di dispositivo specifico dell'hardware prima che il dispositivo venga spento. Ad esempio, un driver miniport WavePci potrebbe dover salvare i registri DMA se l'alimentazione si verifica durante una sequenza di trasferimenti di dati a dispersione/raccolta. Se il sistema sta accendendo (effettuando una transizione di stato verso PowerDeviceD0), PortCls chiama dopo aver chiamato PowerChangeNotifyPowerChangeState e prima di riavviare tutti i flussi di dati audio sospesi. In questo modo il driver miniport può ripristinare un contesto salvato in precedenza dopo che il dispositivo è stato acceso.
Il codice per questo metodo deve risiedere nella memoria di paging.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | portcls.h (include Portcls.h) |