Função PoFxRegisterCoreDevice (pepfx.h)

A rotina PoFxRegisterCoreDevice registra um novo recurso do sistema principal com a PoFx (estrutura de gerenciamento de energia) do Windows.

Sintaxe

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

Parâmetros

[in] Id

Uma cadeia de caracteres que identifica exclusivamente o recurso principal do sistema. Esse membro é um ponteiro para uma estrutura UNICODE_STRING que contém uma cadeia de caracteres de identificação do dispositivo.

[in] Device

Um ponteiro para uma estrutura PO_FX_CORE_DEVICE que descreve as características de energia do recurso principal do sistema.

[out] Handle

Um ponteiro para um local no qual a rotina grava um valor POHANDLE. Esse identificador representa o registro do recurso principal do sistema com PoFx.

Retornar valor

PoFxRegisterCoreDevice retornará STATUS_SUCCESS se a chamada registrar com êxito o PEP. Os possíveis valores retornados por erro incluem os seguintes códigos de status.

Valor retornado	Descrição
STATUS_INVALID_PARAMETER	A contagem de componentes para este dispositivo é zero ou a estrutura PO_FX_CORE_DEVICE contém um número de versão inválido ou o membro ComponentCriticalTransitionCallback dessa estrutura contém um ponteiro de função inválido.
STATUS_INSUFFICIENT_RESOURCES	Não é possível alocar os recursos necessários para concluir o registro solicitado.

Comentários

Essa rotina registra um recurso principal do sistema para que esse recurso possa ser gerenciado por energia pela PoFx.

Os principais recursos do sistema são dispositivos de hardware, como temporizadores e controladores de interrupção, que são gerenciados pela HAL (camada de abstração de hardware) do Windows. Esses dispositivos fornecem funções básicas exigidas pelo sistema operacional. Devido à estreita relação entre os principais recursos do sistema e os processadores, o gerenciamento de energia desses recursos precisa ser coordenado com o gerenciamento de estado ocioso do processador.

A rotina PoFxRegisterCoreDevice deve ser chamada em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 10.
Plataforma de Destino	Windows
Cabeçalho	pepfx.h (inclua Pep_x.h)
Biblioteca	Ntoskrnl.lib
IRQL	PASSIVE_LEVEL

Confira também

PO_FX_CORE_DEVICE

UNICODE_STRING