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

Artigo
02/07/2025

O ComponentActiveConditionCallback rotina de retorno de chamada notifica o driver de que o componente especificado concluiu uma transição da condição ociosa para a condição ativa.

Sintaxe

PO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK PoFxComponentActiveConditionCallback;

void PoFxComponentActiveConditionCallback(
  [in] PVOID Context,
  [in] ULONG Component
)
{...}

Parâmetros

[in] Context

Um ponteiro para o contexto do dispositivo. O driver do dispositivo usa esse contexto para armazenar informações sobre o estado de energia atual do dispositivo. O driver do dispositivo especificou esse ponteiro no DeviceContext membro 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 componentes na estrutura PO_FX_DEVICE que o driver de dispositivo usou para registrar o dispositivo com PoFx. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N–1.

Valor de retorno

Nenhum

Observações

Os registros de hardware de um componente só podem ser acessados quando o componente está na condição ativa. Não confie no estado de energia fx de um componente para determinar se o componente pode ser acessado. Se o componente estiver no estado F0 e estiver na condição ociosa, o componente poderá estar prestes a mudar para outro estado fx.

Para obter acesso a um componente que está na condição ociosa, o driver pode chamar a rotina PoFxActivateComponent para alternar o componente para a condição ativa. Se o componente ainda não estiver na condição ativa quando PoFxActivateComponent for chamado, PoFx iniciará a transição para a condição ativa e, em seguida, chamará a rotina ComponentActiveConditionCallback do para notificar o driver quando a transição for concluída.

O driver recebe um ComponentActiveConditionCallback retorno de chamada sempre que o componente concluir uma transição para a condição ativa, independentemente de o driver chamado PoFxActivateComponent iniciar a transição. Por exemplo, o kernel do Windows pode ativar o componente em nome do driver antes de enviar um IRP Plug and Play ou uma IRP de set-power do sistema para o driver.

Exemplos

Para definir um ComponentActiveConditionCallback rotina de retorno de chamada, primeiro você deve fornecer uma declaração de função que identifique o tipo de rotina de retorno de chamada que você está definindo. O Windows fornece um conjunto de tipos de função de retorno de chamada para drivers. Declarar uma função usando os tipos de função de retorno de chamada ajuda a análise de código para drivers, SDV (Verificador de Driver Estático) e outras ferramentas de verificação encontram erros e é um requisito para gravar drivers para o sistema operacional Windows.

Por exemplo, para definir um ComponentActiveConditionCallback rotina de retorno de chamada denominada MyComponentActiveConditionCallback, use o tipo PO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK conforme mostrado neste exemplo de código:

PO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK MyComponentActiveConditionCallback;

Em seguida, implemente sua rotina de retorno de chamada da seguinte maneira:

_Use_decl_annotations_
VOID
  MyComponentActiveConditionCallback(
    PVOID Context,
    ULONG Component
    )
  {
      // Function body
  }

O tipo de função PO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK é definido no arquivo de cabeçalho Wdm.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação _Use_decl_annotations_ à sua definição de função. A anotação _Use_decl_annotations_ garante que as anotações aplicadas ao tipo de função PO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers WDM. Para obter informações sobre _Use_decl_annotations_, consulte Anotando o comportamento da função.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte a partir do Windows 8.
da Plataforma de Destino	Área de trabalho
cabeçalho	wdm.h (inclua Wudfwdm.h)
IRQL	Chamado no <DO IRQL = DISPATCH_LEVEL.

Consulte também

PO_FX_DEVICE

PoFxActivateComponent

Compartilhar via