Share via

PO_FX_COMPONENT_PERF_STATE_CALLBACK funzione di callback (wdm.h)

  • Articolo

La routine di callback ComponentPerfStateCallback notifica al driver che la richiesta di modifica dello stato delle prestazioni di un componente è stata completata.

Sintassi

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

Parametri

[in] Context

Puntatore al contesto di dispositivo. Il driver di dispositivo usa questo contesto per archiviare informazioni sullo stato di alimentazione corrente del dispositivo. Il driver di dispositivo ha specificato questo puntatore nel membro DeviceContext della struttura PO_FX_DEVICE usata dal driver per registrare il dispositivo con il framework di risparmio energia (PoFx). Questo contesto è opaco a PoFx.

[in] Component

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

[in] Succeeded

Se TRUE, il plug-in dell'estensione della piattaforma (PEP) ha avuto esito positivo sulla modifica dello stato delle prestazioni. Se FALSE, pep non ha superato la modifica dello stato delle prestazioni. Per altre informazioni, vedere la sezione Osservazioni.

[in] RequestContext

Puntatore al contesto facoltativo del driver o del dispositivo specificato dal parametro Context della routine PoFxIssueComponentPerfStateChange o PoFxIssueComponentPerfStateChangeMultiple .

Valore restituito

nessuno

Osservazioni

Quando un driver di dispositivo richiede una modifica dello stato delle prestazioni chiamando la routine PoFxIssueComponentPerfStateChange o PoFxIssueComponentPerfStateChangeMultiple , PoFx chiama la routine ComponentPerfStateCallback per notificare al driver al termine della richiesta.

Per specificare una routine ComponentPerfStateCallback , utilizzare il parametro ComponentPerfStateCallback della routine PoFxRegisterComponentPerfStates quando il driver esegue la registrazione per la gestione dello stato delle prestazioni da Parte di PoFx. La routine ComponentPerfStateCallback può essere la stessa per tutti i componenti e tutti i dispositivi.

Se Succeeded è TRUE, il driver deve eseguire qualsiasi operazione necessaria per modificare lo stato delle prestazioni nell'hardware. Se Succeeded è FALSE, il driver può scegliere di eseguire alcuna operazione o ritentare la richiesta con lo stesso stato di prestazioni o uno stato di prestazioni alternativo.

Requisiti

Requisito Valore
Client minimo supportato Supportato a partire da Windows 10.
Piattaforma di destinazione Desktop
Intestazione wdm.h
IRQL Chiamato in IRQL <= DISPATCH_LEVEL.

Vedi anche

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice