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.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.