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

Artigo
02/07/2025

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

Sintaxe

PO_FX_COMPONENT_IDLE_CONDITION_CALLBACK PoFxComponentIdleConditionCallback;

void PoFxComponentIdleConditionCallback(
  [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

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

Quando o driver não precisa mais acessar um componente que está na condição ativa, o driver deve chamar a rotina PoFxIdleComponent para alternar o componente para a condição ociosa. Em resposta à chamada PoFxIdleComponent, a PoFx inicia a transição para a condição ociosa e, em seguida, chama o ComponentIdleConditionCallback rotina para notificar o driver quando essa transição for concluída.

O driver deve chamar PoFxCompleteIdleCondition em resposta a cada ComponentIdleConditionCallback retorno de chamada. A chamada PoFxCompleteIdleCondition pode ocorrer durante o ComponentIdleConditionCallback retorno de chamada ou após o retorno de chamada retornar. O driver deve concluir qualquer trabalho que exija acesso ao componente de hardware antes da chamada para PoFxCompleteIdleCondition. Após essa chamada, o componente pode não permanecer no estado de energia F0.

Um componente só pode ser acessado com segurança 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.

Exemplos

Para definir um ComponentIdleConditionCallback 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 ComponentIdleConditionCallback rotina de retorno de chamada denominada MyComponentIdleConditionCallback, use o tipo PO_FX_COMPONENT_IDLE_CONDITION_CALLBACK conforme mostrado neste exemplo de código:

PO_FX_COMPONENT_IDLE_CONDITION_CALLBACK MyComponentIdleConditionCallback;

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

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

O tipo de função PO_FX_COMPONENT_IDLE_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_IDLE_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

PoFxCompleteIdleCondition

Compartilhar via