DevicePowerNotify

9/8/2008

Essa função solicita que alteração Power Manager o estado de energia de um dispositivo.

Syntax

DWORD DevicePowerNotify(
  PVOID pvDevice,
  CEDEVICE_POWER_STATE DeviceState,
  DWORD Flags
);

Parameters

• pvDevice
  [no] Especifica o dispositivo. Deve ser um válido LPWSTR Nome dispositivo, por exemplo, COM1:.

• DeviceState
  [no] Indica o estado de energia dispositivo especificado em CEDEVICE_POWER_STATE.

• Sinalizadores
  [no] Definir como POWER_NAME para especificar o nome do dispositivo que está solicitando a solicitação de energia.

Return Value

• ERROR_FILE_NOT_FOUND
  Indica que a classe dispositivo ou o dispositivo de classe de dispositivo não pôde ser encontrado.

• ERROR_INVALID_PARAMETER
  Indica que há não válido parâmetro.

• ERROR_WRITE_FAULT
  Indica que a tentativa atualização o estado de energia dispositivo falha.

• Código de erro Win32
  Propagadas de chamar o IOCTL_POWER_SET.

Remarks

Quando DevicePowerNotify é chamado, qualificar o nome do seu dispositivo com um associado classe. Por exemplo \DSK1 {8DD679CE-8AB4-43 c 8-A14A-EA4963FAA715}: Refere-se a uma potência-gerenciado bloco dispositivo chamado DSK1. Se nenhum qualificação classe está presente, o genérico Power-manageable classe {A32942B7-920 C-486b-B0E6-92A702A99B35} Presume-se.

Um driver de dispositivo pode notificar Power Manager que ele quer alteração seu dispositivo energia nível usando essa função. Se nenhuma entidade solicitou uma potência nível requisito para o dispositivo, Power Manager pode emitir um IOCTL_POWER_SET Para o dispositivo solicitado energia nível. Drivers não devem presumir que bem-sucedido chamadas para esta função resultará em um IOCTL_POWER_SET Ou que subseqüentes IOCTL_POWER_SET As operações são resultado deste chamar.

Oferece suporte a Power Manager DevicePowerNotify Solicitações de um dispositivo durante processamento IOCTL_POWER_CAPABILITIES. Isso permite que os dispositivos que estão definidos para ser carregado em um estado de energia dispositivo Other Than D0 a solicitação que seu estado de energia valor ser atualizado imediatamente seguinte registro com Power Manager. Como com qualquer DevicePowerNotify função chamar, a solicitação não pode resultar em um estado de energia dispositivo atualização. Isso depende de como as restrições impostas ao Power Manager por aplicativos, bem como o estado de energia sistema configuração.

Drivers que suporte gerenciamento de energia deve relatório seus recursos como precisamente como possíveis durante enumeração. A partir de em seguida diante, eles receberão solicitações de Power Manager a get ou alteração sua energia dispositivo estados. Dispositivos que podem gerenciar seu próprios energia deve usar DevicePowerNotify a solicitação que alteração Power Manager seu estado de energia dispositivo.

See Also

Reference

CEDEVICE_POWER_STATE
IOCTL_POWER_SET

Concepts

Power States

Other Resources

Power Management Functions