Funzione PoFxQueryCurrentComponentPerfState (wdm.h)
La routine PoFxQueryCurrentComponentPerfState recupera lo stato delle prestazioni attivo nel set di prestazioni di un componente.
Sintassi
NTSTATUS PoFxQueryCurrentComponentPerfState(
[in] POHANDLE Handle,
[in] ULONG Flags,
[in] ULONG Component,
[in] ULONG SetIndex,
[in] PULONGLONG CurrentPerf
);
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] Flags
Impostare su 0. Attualmente non vengono definiti flag per questa routine.
[in] Component
Indice che identifica il componente lo stato delle prestazioni recuperato. 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] SetIndex
Indice che identifica il set di stato delle prestazioni di cui viene eseguita una query sulle prestazioni. Questo parametro è un indice nella matrice PerfStateSets nella struttura PO_FX_COMPONENT_PERF_INFO utilizzata dal driver del dispositivo per registrare gli stati delle prestazioni del componente con PoFx. Se la matrice PerfStateSets contiene elementi N, gli indici del set di stato delle prestazioni sono compresi tra 0 e N-1.
[in] CurrentPerf
Puntatore a variabile in cui viene restituito lo stato delle prestazioni corrente per il set di stati di prestazioni specificato. Per altre informazioni sul valore restituito, vedere Osservazioni.
Valore restituito
PoFxQueryCurrentComponentPerfState restituisce STATUS_SUCCESS se l'operazione richiesta ha esito positivo. I valori restituiti degli errori possibili includono i codici di stato seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il chiamante ha fornito un indice non valido per il set di stato del componente o del componente. |
Commenti
Un driver può chiamare la routine PoFxQueryCurrentComponentPerfState per recuperare lo stato di prestazioni corrente di un determinato set di prestazioni per un componente. Se la chiamata ha esito positivo, il parametro CurrentPerf viene sovrascritto con un puntatore a un valore che specifica lo stato di prestazioni corrente del set. Questo valore può essere uno dei seguenti, a seconda del contenuto della struttura di PO_FX_COMPONENT_PERF_SET che il driver passato alla routine PoFxRegisterComponentPerfStates :
- Per un set di stato delle prestazioni che rappresenta una distribuzione continua degli stati delle prestazioni, si tratta di un valore tra i membri Minimo e Massimo della struttura PO_FX_COMPONENT_PERF_SET .
- Per un set di stato delle prestazioni che rappresenta un numero discreto di stati di prestazioni, questo valore è un indice nello Stato membro della struttura PO_FX_COMPONENT_PERF_SET .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 10. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h |
| Libreria | Ntoskrnl.lib |
| DLL | Ntoskrnl.exe |
| IRQL | <= DISPATCH_LEVEL |