estrutura PO_FX_DEVICE_V2 (wdm.h)

Artigo
02/07/2025

A estrutura PO_FX_DEVICE descreve os atributos de energia de um dispositivo para a PoFx (estrutura de gerenciamento de energia).

Sintaxe

typedef struct _PO_FX_DEVICE_V2 {
  ULONG                                      Version;
  ULONGLONG                                  Flags;
  PPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK ComponentActiveConditionCallback;
  PPO_FX_COMPONENT_IDLE_CONDITION_CALLBACK   ComponentIdleConditionCallback;
  PPO_FX_COMPONENT_IDLE_STATE_CALLBACK       ComponentIdleStateCallback;
  PPO_FX_DEVICE_POWER_REQUIRED_CALLBACK      DevicePowerRequiredCallback;
  PPO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK  DevicePowerNotRequiredCallback;
  PPO_FX_POWER_CONTROL_CALLBACK              PowerControlCallback;
  PVOID                                      DeviceContext;
  ULONG                                      ComponentCount;
  PO_FX_COMPONENT_V2                         Components[ANYSIZE_ARRAY];
} PO_FX_DEVICE_V2, *PPO_FX_DEVICE_V2;

Membros

Version

O número de versão dessa estrutura. Se o driver se registrar para o suporte de estado de desempenho com PoFx, defina esse membro como PO_FX_VERSION_V2. Caso contrário, defina esse membro como PO_FX_VERSION_V1.

Flags

Definido como 0. Atualmente, nenhum sinalizador é definido para esse membro.

ComponentActiveConditionCallback

Um ponteiro para o ComponentActiveConditionCallback rotina de retorno de chamada implementada pelo driver de dispositivo.

ComponentIdleConditionCallback

Um ponteiro para o ComponentIdleConditionCallback rotina de retorno de chamada implementada pelo driver de dispositivo.

ComponentIdleStateCallback

Um ponteiro para o ComponentIdleStateCallback rotina de retorno de chamada implementada pelo driver de dispositivo.

DevicePowerRequiredCallback

Um ponteiro para o DevicePowerRequiredCallback rotina de retorno de chamada implementada pelo driver de dispositivo.

DevicePowerNotRequiredCallback

Um ponteiro para o DevicePowerNotRequiredCallback rotina de retorno de chamada implementada pelo driver de dispositivo.

PowerControlCallback

Um ponteiro para o PowerControlCallback rotina de retorno de chamada implementada pelo driver de dispositivo.

DeviceContext

Um ponteiro para um contexto de dispositivo alocado por chamador. Esse ponteiro é passado como um parâmetro para cada função de retorno de chamada implementada pelo driver que é apontada por essa estrutura. O driver do dispositivo usa esse contexto para armazenar informações sobre o estado de energia atual do dispositivo. Esse contexto é opaco para PoFx.

ComponentCount

O número de elementos na matriz componentes. Além disso, esse membro especifica o número de componentes no dispositivo.

Components[ANYSIZE_ARRAY]

Esse membro é o primeiro elemento em uma matriz de um ou mais elementos PO_FX_COMPONENT. Se a matriz contiver mais de um elemento, os elementos adicionais seguirão imediatamente a estrutura PO_FX_DEVICE. A matriz contém um elemento para cada componente no dispositivo. O estado de potência fx de cada componente pode ser controlado independentemente dos estados de energia fx dos outros componentes no dispositivo. A constante ANYSIZE_ARRAY é definida como 1 no arquivo de cabeçalho Ntdef.h.

Observações

Para registrar um dispositivo com PoFx, um driver chama o PoFxRegisterDevice rotina e fornece, como parâmetro, um ponteiro para uma estrutura PO_FX_DEVICE que descreve o dispositivo.

Cada elemento na matriz componentes descreve os atributos de estado de energia de um componente no dispositivo. Cada componente no dispositivo é identificado por seu índice de matriz componentes. Rotinas como PoFxActivateComponent e PoFxCompleteIdleCondition usam o índice de matriz de um componente para identificar o componente.

Um driver de dispositivo não é necessário para implementar todas as seis rotinas de retorno de chamada. O driver poderá definir um ponteiro de função na estrutura PO_FX_DEVICE como NULL se o driver não implementar a rotina de retorno de chamada correspondente. No entanto, determinadas rotinas de retorno de chamada devem ser implementadas. Especificamente, se um ou mais componentes em um dispositivo tiver mais de um estado Fx, o driver deverá implementar componentIdleStateCallback, ComponentActiveConditionCallbacke rotinas de ComponentIdleConditionCallback. Caso contrário, o registro do dispositivo falhará e PoFxRegisterDevice retornará STATUS_INVALID_PARAMETER.