PowerManagement_SetSystemPowerProfile İşlevi

Üst bilgi: #include <applibs/powermanagement.h>

Sistem güç profilini ayarlar. Sistem, güç tüketimini ve performansı belirtilen Güç Profiline göre dengelemek için CPU sıklığını dinamik olarak ayarlar.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Not

Güç profilleri yeniden başlatmalar arasında kalıcı olmaz ve uygulamanız başlatıldığında her zaman ayarlanmalıdır.

Parametre

  • PowerManagement_PowerSaver sistemin performansa göre güç tasarruflarına öncelik vermesi gerektiğini belirtir.
  • PowerManagement_Balanced sistemin güç tasarruflarını ve performansı sistem yüküne göre dengelemesi gerektiğini belirtir.
  • PowerManagement_HighPerformance sistemin güç tasarrufuna göre performansa öncelik vermesi gerektiğini gösterir.

Hata

Hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno -1 döndürür.

  • EACCES: Gerekli giriş uygulama bildiriminde listelenmediğinden sistem güç profilini ayarlama erişimine izin verilmez.
  • EINVAL: desired_profile için geçersiz bir sistem güç profili belirtildi.

Diğerleri errno de belirtilebilir. Bu tür hatalar belirlenimci değildir ve sistem güncelleştirmeleri aracılığıyla aynı davranış korunmayabilir.

Dönüş değeri

Başarı için 0 veya hata için -1 döndürür; bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

PowerManagement_SetSystemPowerProfile() kullanmak için uygulamanızın, uygulama bildirimininPowerControls alanında SetPowerProfile değerini bildirmesi gerekir.