Funzione PoFxSetComponentResidency (wdm.h)

Articolo
08/08/2023

La routine PoFxSetComponentResidency imposta il tempo stimato per quanto tempo un componente rimane inattiva dopo che il componente entra nella condizione di inattività.

Sintassi

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

Parametri

[in] Handle

Handle che rappresenta la registrazione del dispositivo con il framework di risparmio energia (PoFx). Il driver di dispositivo ha ricevuto in precedenza questo handle dalla routine PoFxRegisterDevice .

[in] Component

Indice che identifica il componente. Questo parametro è un indice nella matrice Components nella struttura PO_FX_DEVICE utilizzata dal driver del dispositivo per registrare il dispositivo con PoFx. Se la matrice Components contiene elementi N, gli indici dei componenti sono compresi tra 0 e N-1.

[in] Residency

Tempo di residenza stimato, in 100-nanosecondi. Questo parametro è un hint per PoFx per quanto tempo il componente rimane inattiva dopo una transizione dalla condizione attiva alla condizione inattiva. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

nessuno

Osservazioni

Il driver chiamante fornisce un tempo di residenza stimato che PoFx può usare come suggerimento per migliorare le prestazioni. PoFx usa questo hint per selezionare uno stato fx a bassa potenza appropriato per un componente che si trova nella condizione inattiva.

Il driver del dispositivo può chiamare PoFxSetComponentResidency ogni volta che una modifica nelle circostanze richiede una modifica nel tempo di residenza stimato. Dopo ogni chiamata, il nuovo tempo di residenza stimato rimane effettivo finché il driver chiama PoFxSetComponentResidency per aggiornarlo.

Se un componente si trova nella condizione inattiva quando viene chiamato PoFxSetComponentResidency, PoFx potrebbe modificare lo stato fx del componente per soddisfare il nuovo tempo di residenza stimato specificato dal chiamante.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Piattaforma di destinazione	Universale
Intestazione	wdm.h
Libreria	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL

Share via