PO_FX_COMPONENT_PERF_STATE_CALLBACK função de retorno de chamada (wdm.h)

  • Artigo

A rotina de retorno de chamada ComponentPerfStateCallback notifica o driver de que sua solicitação para alterar o estado de desempenho de um componente foi concluída.

Sintaxe

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

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

Parâmetros

[in] Context

Um ponteiro para o contexto do dispositivo. O driver de dispositivo usa esse contexto para armazenar informações sobre o estado de energia atual do dispositivo. O driver de dispositivo especificou esse ponteiro no membro DeviceContext da estrutura PO_FX_DEVICE que o driver usou para registrar o dispositivo com a PoFx (estrutura de gerenciamento de energia). Esse contexto é opaco para PoFx.

[in] Component

Especifica o índice que identifica o componente. Esse parâmetro é um índice na matriz Components na estrutura PO_FX_DEVICE que o driver de dispositivo usou para registrar o dispositivo com PoFx. Se a matriz Components contiver N elementos, os índices de componentes variam de 0 a N–1.

[in] Succeeded

Se TRUE, o PEP (plug-in de extensão de plataforma) obteve êxito na alteração do estado de desempenho. Se FALSE, o PEP falhou na alteração do estado de desempenho. Para obter mais informações, consulte a seção Comentários.

[in] RequestContext

Ponteiro para o contexto opcional de driver ou dispositivo especificado pelo parâmetro Context da rotina PoFxIssueComponentPerfStateChange ou PoFxIssueComponentPerfStateChangeMultiple .

Retornar valor

Nenhum

Comentários

Quando um driver de dispositivo solicita uma alteração de estado de desempenho chamando a rotina PoFxIssueComponentPerfStateChange ou PoFxIssueComponentPerfStateChangeMultiple , a PoFx chama a rotina ComponentPerfStateCallback para notificar o driver quando a solicitação for concluída.

Para especificar uma rotina ComponentPerfStateCallback , use o parâmetro ComponentPerfStateCallback da rotina PoFxRegisterComponentPerfStates quando o driver se registrar para o gerenciamento de estado de desempenho pela PoFx. A rotina ComponentPerfStateCallback pode ser a mesma para todos os componentes e todos os dispositivos.

Se Êxito for TRUE, o driver deverá executar qualquer trabalho necessário para alterar o estado de desempenho no hardware. Se Êxito for FALSE, o driver poderá optar por não fazer nada ou repetir a solicitação com o mesmo estado de desempenho ou um estado de desempenho alternativo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte a partir do Windows 10.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h
IRQL Chamado em IRQL <= DISPATCH_LEVEL.

Confira também

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice