Compartilhar via

Função DevicePowerEnumDevices (powrprof.h)

  • Artigo

Enumera dispositivos no sistema que atendem aos critérios especificados.

Sintaxe

BOOLEAN DevicePowerEnumDevices(
  [in]            ULONG  QueryIndex,
  [in]            ULONG  QueryInterpretationFlags,
  [in]            ULONG  QueryFlags,
  [out, optional] PBYTE  pReturnBuffer,
  [in, out]       PULONG pBufferSize
);

Parâmetros

[in] QueryIndex

O índice do dispositivo solicitado. Para chamadas iniciais, esse valor deve ser zero.

[in] QueryInterpretationFlags

Os critérios aplicados aos resultados da pesquisa.

Valor Significado
DEVICEPOWER_HARDWAREID
0x80000000
 Retornar uma cadeia de caracteres de ID de hardware em vez de um nome de dispositivo amigável.
DEVICEPOWER_FILTER_DEVICES_PRESENT
0x20000000
 Ignorar dispositivos que não estão presentes no sistema no momento.
DEVICEPOWER_AND_OPERATION
0x40000000
 Execute uma operação AND em QueryFlags.
DEVICEPOWER_FILTER_WAKEENABLED
0x08000000
 Verifique se o dispositivo está habilitado no momento para ativar o sistema de um estado de suspensão.
DEVICEPOWER_FILTER_ON_NAME
0x02000000
 Localize um dispositivo cujo nome corresponda à cadeia de caracteres passada em pReturnBuffer e marcar seus recursos em relação a QueryFlags.

[in] QueryFlags

Os critérios de consulta.

Valor Significado
PDCAP_D0_SUPPORTED
0x00000001
 O dispositivo dá suporte ao estado de energia do sistema D0.
PDCAP_D1_SUPPORTED
0x00000002
 O dispositivo dá suporte ao estado de energia do sistema D1.
PDCAP_D2_SUPPORTED
0x00000004
 O dispositivo dá suporte ao estado de energia do sistema D2.
PDCAP_D3_SUPPORTED
0x00000008
 O dispositivo dá suporte ao estado de energia do sistema D3.
PDCAP_S0_SUPPORTED
0x00010000
 O dispositivo dá suporte ao estado de suspensão do sistema S0.
PDCAP_S1_SUPPORTED
0x00020000
 O dispositivo dá suporte ao estado de suspensão do sistema S1.
PDCAP_S2_SUPPORTED
0x00040000
 O dispositivo dá suporte ao estado de suspensão do sistema S2.
PDCAP_S3_SUPPORTED
0x00080000
 O dispositivo dá suporte ao estado de suspensão do sistema S3.
PDCAP_S4_SUPPORTED
0x01000000
 O dispositivo dá suporte ao estado de suspensão do sistema S4.
PDCAP_S5_SUPPORTED
0x02000000
 O dispositivo dá suporte ao estado de suspensão do sistema S5.
PDCAP_WAKE_FROM_D0_SUPPORTED
0x00000010
 O dispositivo dá suporte à ativação do estado de energia do sistema D0.
PDCAP_WAKE_FROM_D1_SUPPORTED
0x00000020
 O dispositivo dá suporte à ativação do estado de energia do sistema D1.
PDCAP_WAKE_FROM_D2_SUPPORTED
0x00000040
 O dispositivo dá suporte à ativação do estado de energia do sistema D2.
PDCAP_WAKE_FROM_D3_SUPPORTED
0x00000080
 O dispositivo dá suporte à ativação do estado de energia do sistema D3.
PDCAP_WAKE_FROM_S0_SUPPORTED
0x00100000
 O dispositivo dá suporte à ativação do estado de suspensão do sistema S0.
PDCAP_WAKE_FROM_S1_SUPPORTED
0x00200000
 O dispositivo dá suporte à ativação do estado de suspensão do sistema S1.
PDCAP_WAKE_FROM_S2_SUPPORTED
0x00400000
 O dispositivo dá suporte à ativação do estado de suspensão do sistema S2.
PDCAP_WAKE_FROM_S3_SUPPORTED
0x00800000
 O dispositivo dá suporte à ativação do estado de suspensão do sistema S3.
PDCAP_WARM_EJECT_SUPPORTED
0x00000100
 O dispositivo dá suporte à ejeção quente.

[out, optional] pReturnBuffer

Ponteiro para um buffer que recebe as informações solicitadas.

[in, out] pBufferSize

O tamanho, em bytes, do buffer de retorno.

Nota Se pReturnBuffer for NULL, pBufferSize será preenchido com o tamanho necessário para retornar os dados.
 

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Os valores do parâmetro QueryFlags podem ser combinados para consultar dispositivos que dão suporte a dois ou mais critérios. Por exemplo; se PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED for passado como o parâmetro QueryFlags , a função consultará dispositivos que dão suporte a D3 ou D1.

QueryFlags também pode ser combinado com QueryInterpretationFlags definido comoDEVICEPOWER_AND_OPERATION para produzir uma consulta de dispositivos que dão suporte a todos os critérios solicitados. Por exemplo; se PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED for passado como o parâmetro QueryFlags e DEVICEPOWER_AND_OPERATION for passado como o parâmetro QueryInterpretationFlags , a função consultará dispositivos que dão suporte a D3 e D1.

Exemplos

Para obter um exemplo que usa essa função, consulte Usando a API de Energia do Dispositivo.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho powrprof.h
Biblioteca PowrProf.lib
DLL PowrProf.dll

Confira também

Gerenciamento de Energia do Dispositivo