Funzione PoSetDeviceBusyEx (wdm.h)

Articolo
08/08/2023

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