Manager: Power Manager


Carbon supports Power Manager functions prior to Power Manager 2.0. However, many of these functions do nothing on Mac OS X; these calls have been retained in Carbon as the only means for implementing power management on Mac OS 8 and 9. Before using any of the Power Manager API, you should call the PMFeatures function to check the availability of the feature you wish to use. On Mac OS X, use the functions provided in IOKit for power management. For more information on IOKit, see http://developer.apple.com/techpubs/macosx/Kernel/IOKitFundamentals/index.html

Unsupported  AddDevicePowerHandler

Not available in CarbonLib. Not available in Mac OS X.

Unsupported  AddPowerSource

Not available in CarbonLib. Not available in Mac OS X.

Supported  AOff

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, AOff is unimplemented. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  AOn

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, AOn is unimplemented. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  AOnIgnoreModem

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, AOnIgnoreModem is unimplemented. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  AutoSleepControl

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, AutoSleepControl is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  BatteryCount

Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  BatteryStatus

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, BatteryStatus is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  BOff

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, BOff is unimplemented. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  BOn

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, BOn is unimplemented. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  CurrentProcessorSpeed

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, CurrentProcessorSpeed is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  DelaySystemIdle

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, DelaySystemIdle is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  DimmingControl

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, DimmingControl is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  DisableIdle

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, DisableIdle is unimplemented. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DisableWUTime

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, DisableWUTime is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DisposeHDSpindownUPP

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, DisposeHDSpindownUPP is unimplemented. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  DisposePMgrStateChangeUPP

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, DisposePMgrStateChangeUPP is unimplemented. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  DisposePowerHandlerUPP

Supported  DisposeSleepQUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  EnableIdle

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, EnableIdle is unimplemented. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  EnablePCIPowerOff

Not available in CarbonLib. Not available in Mac OS X.

Supported  EnableProcessorCycling

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, EnableProcessorCycling is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  EnableServerMode

Not available in CarbonLib. Not available in Mac OS X.

Supported  FullProcessorSpeed

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, FullProcessorSpeed is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetBatteryTimes

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetBatteryTimes is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetBatteryVoltage

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetBatteryVoltage is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  GetCoreProcessorTemperature

Not available in CarbonLib. Not available in Mac OS X.

Supported  GetCPUSpeed

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetDevicePowerLevel

Not available in CarbonLib. Not available in Mac OS X.

Supported  GetDimmingTimeout

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetDimmingTimeout is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetDimSuspendState

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetDimSuspendState is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.1 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetHardDiskTimeout

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetHardDiskTimeout is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetIntModemInfo

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetIntModemInfo is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetLastActivity

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetLastActivity is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetScaledBatteryInfo

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetScaledBatteryInfo is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetSCSIDiskModeAddress

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetSCSIDiskModeAddress is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetSleepTimeout

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetSleepTimeout is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetSoundMixerState

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetSoundMixerState is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.1 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetStartupTimer

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetStartupTimer is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  GetWakeOnNetworkOptions

Not available in CarbonLib. Not available in Mac OS X.

Supported  GetWakeupTimer

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetWakeupTimer is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetWUTime

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, GetWUTime is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HardDiskPowered

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, HardDiskPowered is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  HardDiskQInstall

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, HardDiskQInstall is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  HardDiskQRemove

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, HardDiskQRemove is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  IdleUpdate

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, IdleUpdate is unimplemented. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  InvokeHDSpindownUPP

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, InvokeHDSpindownUPP is unimplemented. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  InvokePMgrStateChangeUPP

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, InvokePMgrStateChangeUPP is unimplemented. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  InvokePowerHandlerUPP

Supported  InvokeSleepQUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  IsAutoSlpControlDisabled

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, IsAutoSlpControlDisabled is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  IsDimmingControlDisabled

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, IsDimmingControlDisabled is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  IsPCIPowerOffDisabled

Not available in CarbonLib. Not available in Mac OS X.

Supported  IsProcessorCyclingEnabled

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, IsProcessorCyclingEnabled is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  IsServerModeEnabled

Not available in CarbonLib. Not available in Mac OS X.

Supported  IsSpindownDisabled

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, IsSpindownDisabled is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MaximumProcessorSpeed

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, MaximumProcessorSpeed is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MinimumProcessorSpeed

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, MinimumProcessorSpeed is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  ModemStatus

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, ModemStatus is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  NewHDSpindownUPP

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, NewHDSpindownUPP is unimplemented. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  NewPMgrStateChangeUPP

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, NewPMgrStateChangeUPP is unimplemented. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  NewPowerHandlerUPP

Supported  NewSleepQUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  NumBatteriesInstalled

Not available in CarbonLib. Not available in Mac OS X.

Supported  PMFeatures

Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  PMgrStateQInstall

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, PMgrStateQInstall is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  PMgrStateQRemove

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, PMgrStateQRemove is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  PMSelectorCount

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, PMSelectorCount is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  RemoveDevicePowerHandler

Not available in CarbonLib. Not available in Mac OS X.

Unsupported  RemoveDevicePowerHandlerForProc

Not available in CarbonLib. Not available in Mac OS X.

Unsupported  RemovePowerSource

Not available in CarbonLib. Not available in Mac OS X.

Unsupported  SetDevicePowerLevel

Not available in CarbonLib. Not available in Mac OS X.

Supported  SetDimmingTimeout

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetDimmingTimeout is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetDimSuspendState

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetDimSuspendState is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.1 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetHardDiskTimeout

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetHardDiskTimeout is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetIntModemState

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetIntModemState is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetProcessorSpeed

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetProcessorSpeed is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetSCSIDiskModeAddress

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetSCSIDiskModeAddress is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetSleepTimeout

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetSleepTimeout is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetSoundMixerState

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetSoundMixerState is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.1 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetSpindownDisable

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetSpindownDisable is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetStartupTimer

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetStartupTimer is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  SetWakeOnNetworkOptions

Not available in CarbonLib. Not available in Mac OS X.

Supported  SetWakeupTimer

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetWakeupTimer is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetWUTime

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SetWUTime is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SleepQInstall

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SleepQRemove

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SpinDownHardDisk

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, SpinDownHardDisk is unimplemented. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  UpdatePowerSource

Not available in CarbonLib. Not available in Mac OS X.

Supported  UpdateSystemActivity

Calling this function on Mac OS X does nothing. Although available through Carbon on Mac OS X, UpdateSystemActivity is unimplemented and will return an unimpErr error. Available in CarbonLib 1.0 and later when PowerMgr 1.0 or later is present. Available in Mac OS X 10.0 and later.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 12/12/2001. Copyright © 1999-2001 Apple Computer, Inc. All rights reserved.