Funzione PoSetDeviceBusyEx (wdm.h)
La routine PoSetDeviceBusyEx notifica al risparmio energia che il dispositivo associato al contatore di inattività specificato è occupato.
Sintassi
void PoSetDeviceBusyEx(
[in, out] PULONG IdlePointer
);
Parametri
[in, out] IdlePointer
Puntatore a un contatore inattiva. Si tratta di un valore del puntatore restituito in precedenza dalla routine PoRegisterDeviceForIdleDetection . Poiché PoRegisterDeviceForIdleDetection potrebbe restituire un puntatore NULL , il chiamante deve verificare che il puntatore non sia NULL prima di chiamare PoSetDeviceBusyEx.
Valore restituito
nessuno
Osservazioni
Questa routine è una sostituzione diretta per la macro PoSetDeviceBusy . Se si scrive nuovo codice driver per Windows Vista con Service Pack 1 (SP1) e versioni successive di Windows, chiamare PoSetDeviceBusyEx invece di PoSetDeviceBusy.
Un driver chiama le routine PoSetDeviceBusyEx e PoRegisterDeviceForIdleDetection per abilitare il rilevamento di inattività del sistema per il dispositivo. Se un dispositivo registrato per il rilevamento inattivo rimane inattivo per il periodo di timeout specificato dal driver, il risparmio energia invia una richiesta di IRP_MN_SET_POWER per inserire il dispositivo in uno stato di sospensione richiesto.
PoSetDeviceBusyEx segnala che il dispositivo è occupato, in modo che il risparmio energia possa riavviare il conto alla rovescia di inattività. Se il dispositivo è in stato di sospensione, PoSetDeviceBusyEx non modifica lo stato del dispositivo. Ciò significa che il sistema non invia una richiesta di IRP_MN_SET_POWER di risvegliare il dispositivo.
PoSetDeviceBusyEx è progettato per l'uso con operazioni di I/O relativamente brevi rispetto al periodo di timeout del contatore inattivo. Per operazioni più lunghe che potrebbero superare questo periodo, usare invece le routine PoStartDeviceBusy e PoEndDeviceBusy .
Un driver che effettua più richieste per brevi operazioni di I/O deve chiamare PoSetDeviceBusyEx per ogni richiesta di I/O eseguita.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows Vista con SP1. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualsiasi livello |