Manager: Low Memory Accessors



Carbon will support most of the accessor functions for low-memory variables. However, you should always avoid using low-memory accessors if there are direct Mac OS Toolbox calls to obtain the same information. For example:

* Use the function TickCount instead of the low-memory accessor function LMGetTicks.

* Use the function FrontWindow instead of the low-memory accessor function LMGetWindowList, when possible.

* Use the function PBGetFCBInfo instead of walking the FCB table with the low-memory accessor function LMGetFCBSPtr.

In general, don't think of the values returned by low-memory accessor routines as residing in low memory--think of them as information, possibly associated with a specific Toolbox manager, that is returned by the Mac OS. In the future, Apple may supply new functions, distributed among the Mac OS Toolbox managers, for retrieving this information.

Some low-memory accessor functions are likely to become obsolete in Mac OS X. The following Resource Manager-related functions will not be supported:

* LMGetTopMapHndl and LMSetTopMapHndl

* LMGetSysMapHndl and LMSetSysMapHndl

* LMGetCurMapHndl and LMSetCurMapHndl

Supported  LMGetABusDCE

Supported  LMGetABusGlobals

Supported  LMGetABusVars

Unsupported  LMGetACount

You should instead use GetAlertStage.

Unsupported  LMGetANumber

Supported  LMGetApFontID

Supported  LMGetApplLimit

Supported  LMGetApplScratch

Supported  LMGetApplZone

Supported  LMGetAppParmHandle

Supported  LMGetATalkHk2

Unsupported  LMGetAtMenuBottom

This function will be replaced by a new menu tracking API.

Unsupported  LMGetAuxWinHead

Auxiliary window records are not supported in Carbon. You can use Get/SetWindowContentColor to get or set the content color of a window.

Supported  LMGetBootDrive

Supported  LMGetBufPtr

Supported  LMGetBufTgDate

Supported  LMGetBufTgFBkNum

Supported  LMGetBufTgFFlg

Supported  LMGetBufTgFNum

Unsupported  LMGetCaretTime

You should instead use GetCaretTime.

Supported  LMGetCPUFlag

Supported  LMGetCrsrBusy

Supported  LMGetCrsrThresh

Unsupported  LMGetCurActivate

Supported  LMGetCurApName

Supported  LMGetCurApRefNum

Unsupported  LMGetCurDeactive

Supported  LMGetCurDirStore

Supported  LMGetCurJTOffset

Unsupported  LMGetCurMap

Functions that access the resource map will not be supported.

Supported  LMGetCurPageOption

Supported  LMGetCurPitch

Unsupported  LMGetCurrentA5

68K-specific.

Supported  LMGetCursorNew

Supported  LMGetCurStackBase

Unsupported  LMGetDABeeper

Unsupported  LMGetDAStrings

You should instead use GetParamText.

Supported  LMGetDefltStack

Supported  LMGetDefVCBPtr

Unsupported  LMGetDeskCPat

Setting the desktop pattern programmatically is not supported in Carbon.

Unsupported  LMGetDeskHook

Unsupported  LMGetDeskPattern

Setting the desktop pattern programmatically is not supported in Carbon.

Supported  LMGetDeviceList

Supported  LMGetDiskFormatingHFSDefaults

Unsupported  LMGetDlgFont

You can set fonts directly with SetControlFontStyle.

Unsupported  LMGetDoubleTime

You should instead use GetDoubleTime.

Unsupported  LMGetDragHook

Drag hooks are not supported in Carbon.

Unsupported  LMGetDragPattern

Drag patterns are not supported in Carbon.

Supported  LMGetDrvQHdr

Unsupported  LMGetDSAlertRect

Unsupported  LMGetDSAlertTab

Unsupported  LMGetDSErrCode

Supported  LMGetDTQueue

Unsupported  LMGetEventQueue

You should instead use the new high-level event queue functions provided by the Carbon Event Manager.

Supported  LMGetExtStsDT

Supported  LMGetFCBSPtr

Supported  LMGetFinderName

Supported  LMGetFractEnable

Supported  LMGetFScaleDisable

Supported  LMGetFSFCBLen

Supported  LMGetFSQHdr

Unsupported  LMGetGhostWindow

Unsupported  LMGetGNEFilter

Unsupported  LMGetGrayRgn

You should instead use GetGrayRgn.

Supported  LMGetGZMoveHnd

Supported  LMGetGZRootHnd

Supported  LMGetHeapEnd

Supported  LMGetHighHeapMark

Supported  LMGetHiliteMode

Supported  LMGetHiliteRGB

Supported  LMGetHWCfgFlags

Supported  LMGetIntlSpec

Supported  LMGetJDTInstall

Supported  LMGetJFetch

Supported  LMGetJIODone

Supported  LMGetJournalRef

Supported  LMGetJStash

Supported  LMGetJVBLTask

Supported  LMGetKbdLast

Supported  LMGetKbdType

Supported  LMGetKeyRepThresh

Supported  LMGetKeyThresh

Supported  LMGetKeyTime

Supported  LMGetLastFOND

Supported  LMGetLastSPExtra

Supported  LMGetLo3Bytes

Supported  LMGetLvl2DT

Supported  LMGetMainDevice

Unsupported  LMGetMBarEnable

Originally used to support desk accessories. Now obsolete.

Unsupported  LMGetMBarHeight

Use GetMBarHeight instead. If you are using this function to hide the menu bar, use Hide/ShowMenuBar instead.

Unsupported  LMGetMBarHook

Replaced by new events supported by the Carbon event model.

Supported  LMGetMBTicks

Supported  LMGetMemErr

Supported  LMGetMemTop

Unsupported  LMGetMenuCInfo

Obsolete.

Unsupported  LMGetMenuDisable

Replaced by GetMenuTrackingData API.

Supported  LMGetMenuFlash

Unsupported  LMGetMenuHook

Replaced by new events supported by the Carbon event model.

Unsupported  LMGetMenuList

Will be replaced by a new API.

Supported  LMGetMinStack

Supported  LMGetMinusOne

Supported  LMGetMMU32Bit

Unsupported  LMGetMouseButtonState

You should instead use the Button function.

Unsupported  LMGetMouseLocation

You should instead use GetGlobalMouse.

Unsupported  LMGetMouseTemp

Unsupported  LMGetOldContent

Unsupported  LMGetOldStructure

Supported  LMGetOneOne

Unsupported  LMGetPaintWhite

Supported  LMGetPortAInfo

Supported  LMGetPortBUse

Supported  LMGetPrintErr

Supported  LMGetQDColors

Supported  LMGetRAMBase

Unsupported  LMGetRawMouseLocation

You should instead use GetGlobalMouse.

Supported  LMGetResErr

Supported  LMGetResErrProc

Supported  LMGetResLoad

Unsupported  LMGetResumeProc

Supported  LMGetRndSeed

Supported  LMGetROM85

Supported  LMGetROMBase

Supported  LMGetROMFont0

Supported  LMGetROMMapHandle

Supported  LMGetROMMapInsert

Unsupported  LMGetSaveUpdate

Unsupported  LMGetSaveVisRgn

Supported  LMGetSCCRd

Supported  LMGetSCCWr

Unsupported  LMGetScrapCount

Unsupported  LMGetScrapHandle

Unsupported  LMGetScrapName

Unsupported  LMGetScrapSize

Unsupported  LMGetScrapState

Supported  LMGetScratch20

Supported  LMGetScrDmpEnb

Supported  LMGetScrHRes

Supported  LMGetScrnBase

Supported  LMGetScrVRes

Supported  LMGetSdVolume

Supported  LMGetSEvtEnb

Supported  LMGetSFSaveDisk

Supported  LMGetSoundBase

Supported  LMGetSoundLevel

Supported  LMGetSoundPtr

Supported  LMGetSPAlarm

Supported  LMGetSPATalkA

Supported  LMGetSPATalkB

Supported  LMGetSPClikCaret

Supported  LMGetSPConfig

Supported  LMGetSPFont

Supported  LMGetSPKbd

Supported  LMGetSPMisc2

Supported  LMGetSPPortA

Supported  LMGetSPPortB

Supported  LMGetSPPrint

Supported  LMGetSPValid

Supported  LMGetSPVolCtl

Supported  LMGetStackLowPoint

Supported  LMGetSynListHandle

Unsupported  LMGetSysEvtMask

Supported  LMGetSysFontFam

Supported  LMGetSysFontSize

Supported  LMGetSysMap

Unsupported  LMGetSysMapHndl

Functions that access the resource map will not be supported.

Supported  LMGetSysResName

Supported  LMGetSysZone

Supported  LMGetTEDoText

Supported  LMGetTERecal

Supported  LMGetTEScrpHandle

Supported  LMGetTEScrpLength

Supported  LMGetTESysJust

Unsupported  LMGetTheCursor

The cursor image is not available to Carbon applications.

Supported  LMGetTheGDevice

Supported  LMGetTheMenu

Supported  LMGetTheZone

Unsupported  LMGetTicks

You should instead use TickCount.

Unsupported  LMGetTime

You should instead use GetDateTime.

Supported  LMGetTimeDBRA

Supported  LMGetTimeSCCDB

Supported  LMGetTimeSCSIDB

Supported  LMGetTmpResLoad

Supported  LMGetToExtFS

Supported  LMGetToolScratch

Unsupported  LMGetTopMapHndl

Functions that access the resource map will not be supported.

Unsupported  LMGetTopMenuItem

Replaced by GetMenuTrackingData API.

Supported  LMGetUnitTableEntryCount

Supported  LMGetUTableBase

Supported  LMGetVBLQueue

Supported  LMGetVCBQHdr

Supported  LMGetVIA

Supported  LMGetWidthListHand

Supported  LMGetWidthPtr

Supported  LMGetWidthTabHandle

Unsupported  LMGetWindowList

You should instead use GetWindowList.

Unsupported  LMGetWMgrPort

The Window Manager port is not supported in Carbon.

Supported  LMGetWordRedraw

Unsupported  LMSetABusDCE

Unsupported  LMSetABusGlobals

Unsupported  LMSetABusVars

Unsupported  LMSetACount

You should instead use ResetAlertStage.

Unsupported  LMSetANumber

Supported  LMSetApFontID

Supported  LMSetApplLimit

Supported  LMSetApplScratch

Supported  LMSetApplZone

Supported  LMSetAppParmHandle

Supported  LMSetATalkHk2

Unsupported  LMSetAtMenuBottom

Replaced by new MDEF messages and GetMenuTrackingData API.

Unsupported  LMSetAuxWinHead

Auxiliary window records are not supported in Carbon. You can use Get/SetWindowContentColor to get or set the content color of a window.

Supported  LMSetBootDrive

Supported  LMSetBufPtr

Supported  LMSetBufTgDate

Supported  LMSetBufTgFBkNum

Supported  LMSetBufTgFFlg

Supported  LMSetBufTgFNum

Unsupported  LMSetCaretTime

Supported  LMSetCPUFlag

Supported  LMSetCrsrBusy

Supported  LMSetCrsrThresh

Unsupported  LMSetCurActivate

Supported  LMSetCurApName

Supported  LMSetCurApRefNum

Unsupported  LMSetCurDeactive

Supported  LMSetCurDirStore

Supported  LMSetCurJTOffset

Unsupported  LMSetCurMap

Functions that access the resource map will not be supported.

Supported  LMSetCurPageOption

Supported  LMSetCurPitch

Unsupported  LMSetCurrentA5

68K-specific.

Supported  LMSetCursorNew

Supported  LMSetCurStackBase

Unsupported  LMSetDABeeper

Unsupported  LMSetDAStrings

You should instead use ParamText.

Supported  LMSetDefltStack

Supported  LMSetDefVCBPtr

Unsupported  LMSetDeskCPat

Setting the desktop pattern programmatically is not supported in Carbon.

Unsupported  LMSetDeskHook

Unsupported  LMSetDeskPattern

Setting the desktop pattern programmatically is not supported in Carbon.

Supported  LMSetDeviceList

Supported  LMSetDiskFormatingHFSDefaults

Unsupported  LMSetDlgFont

You can set fonts directly with SetControlFontStyle.

Unsupported  LMSetDoubleTime

Unsupported  LMSetDragHook

Drag hooks are not supported in Carbon.

Unsupported  LMSetDragPattern

Drag hooks are not supported in Carbon.

Supported  LMSetDrvQHdr

Unsupported  LMSetDSAlertRect

Unsupported  LMSetDSAlertTab

Unsupported  LMSetDSErrCode

Supported  LMSetDTQueue

Unsupported  LMSetEventQueue

Supported  LMSetExtStsDT

Supported  LMSetFCBSPtr

Supported  LMSetFinderName

Supported  LMSetFractEnable

Supported  LMSetFScaleDisable

Supported  LMSetFSFCBLen

Unsupported  LMSetGhostWindow

Ghost windows are not supported in Carbon.

Unsupported  LMSetGNEFilter

You should instead use the new Carbon Event Manager functions.

Unsupported  LMSetGrayRgn

The gray region is read-only in Carbon. You can use the GetGrayRgn function to get the gray region, but you can't set it.

Supported  LMSetGZMoveHnd

Supported  LMSetGZRootHnd

Supported  LMSetHeapEnd

Supported  LMSetHighHeapMark

Supported  LMSetHiliteMode

Supported  LMSetHiliteRGB

Supported  LMSetHWCfgFlags

Supported  LMSetIntlSpec

Supported  LMSetJDTInstall

Supported  LMSetJFetch

Supported  LMSetJIODone

Supported  LMSetJournalRef

Supported  LMSetJStash

Supported  LMSetJVBLTask

Supported  LMSetKbdLast

Supported  LMSetKbdType

Supported  LMSetKeyRepThresh

Supported  LMSetKeyThresh

Supported  LMSetKeyTime

Supported  LMSetLastFOND

Supported  LMSetLastSPExtra

Supported  LMSetLo3Bytes

Supported  LMSetLvl2DT

Supported  LMSetMainDevice

Unsupported  LMSetMBarEnable

This accessor was originally used by desk accessories but is now obsolete.

Unsupported  LMSetMBarHeight

Do not hide and show the menu bar by adjusting the menu bar height. Use the HideMenuBar and ShowMenuBar functions instead.

Unsupported  LMSetMBarHook

Replaced by new events supported by the Carbon event model.

Supported  LMSetMBTicks

Supported  LMSetMemErr

Supported  LMSetMemTop

Unsupported  LMSetMenuCInfo

This value was not used by applications and is now obsolete.

Unsupported  LMSetMenuDisable

Replaced by new MDEF messages.

Unsupported  LMSetMenuFlash

Not supported--you shouldn't be setting this value.

Unsupported  LMSetMenuHook

Replaced by new events supported by the Carbon event model.

Unsupported  LMSetMenuList

Supported  LMSetMinStack

Supported  LMSetMinusOne

Supported  LMSetMMU32Bit

Unsupported  LMSetMouseButtonState

Unsupported  LMSetMouseLocation

Supported  LMSetMouseTemp

Unsupported  LMSetOldContent

Unsupported  LMSetOldStructure

Supported  LMSetOneOne

Unsupported  LMSetPaintWhite

You should instead use the window painting functions provided by the Window Manager.

Supported  LMSetPortAInfo

Supported  LMSetPortBUse

Supported  LMSetPrintErr

Supported  LMSetQDColors

Supported  LMSetRAMBase

Unsupported  LMSetRawMouseLocation

Supported  LMSetResErr

Supported  LMSetResErrProc

Supported  LMSetResLoad

Unsupported  LMSetResumeProc

Supported  LMSetRndSeed

Supported  LMSetROM85

Supported  LMSetROMBase

Supported  LMSetROMFont0

Supported  LMSetROMMapHandle

Supported  LMSetROMMapInsert

Unsupported  LMSetSaveUpdate

Unsupported  LMSetSaveVisRgn

Supported  LMSetSCCRd

Supported  LMSetSCCWr

Unsupported  LMSetScrapCount

Unsupported  LMSetScrapHandle

Not supported. Use high-level API.

Unsupported  LMSetScrapName

Not supported. Use high-level API.

Unsupported  LMSetScrapSize

Not supported. Use high-level API.

Unsupported  LMSetScrapState

Not supported. Use high-level API.

Supported  LMSetScratch20

Supported  LMSetScrDmpEnb

Supported  LMSetScrHRes

Supported  LMSetScrnBase

Supported  LMSetScrVRes

Supported  LMSetSdVolume

Supported  LMSetSEvtEnb

Supported  LMSetSFSaveDisk

Supported  LMSetSoundBase

Supported  LMSetSoundLevel

Supported  LMSetSoundPtr

Supported  LMSetSPAlarm

Supported  LMSetSPATalkA

Supported  LMSetSPATalkB

Supported  LMSetSPClikCaret

Supported  LMSetSPConfig

Supported  LMSetSPFont

Supported  LMSetSPKbd

Supported  LMSetSPMisc2

Supported  LMSetSPPortA

Supported  LMSetSPPortB

Supported  LMSetSPPrint

Supported  LMSetSPValid

Supported  LMSetSPVolCtl

Supported  LMSetStackLowPoint

Supported  LMSetSynListHandle

Unsupported  LMSetSysEvtMask

You should instead use SetEventMask.

Supported  LMSetSysFontFam

Supported  LMSetSysFontSize

Supported  LMSetSysMap

Unsupported  LMSetSysMapHndl

Functions that access the resource map will not be supported.

Supported  LMSetSysResName

Supported  LMSetSysZone

Supported  LMSetTEDoText

Supported  LMSetTERecal

Supported  LMSetTEScrpHandle

Supported  LMSetTEScrpLength

Supported  LMSetTESysJust

Unsupported  LMSetTheCursor

Supported  LMSetTheGDevice

Unsupported  LMSetTheMenu

Supported  LMSetTheZone

Unsupported  LMSetTicks

Unsupported  LMSetTime

You should instead use SetDateTime.

Supported  LMSetTimeDBRA

Supported  LMSetTimeSCCDB

Supported  LMSetTimeSCSIDB

Supported  LMSetTmpResLoad

Supported  LMSetToExtFS

Supported  LMSetToolScratch

Unsupported  LMSetTopMapHndl

Functions that access the resource map will not be supported.

Unsupported  LMSetTopMenuItem

Will be replaced by new MDEF messages.

Supported  LMSetUnitTableEntryCount

Supported  LMSetUTableBase

Supported  LMSetVBLQueue

Supported  LMSetVCBQHdr

Supported  LMSetVIA

Supported  LMSetWidthListHand

Supported  LMSetWidthPtr

Supported  LMSetWidthTabHandle

Unsupported  LMSetWindowList

The window list is read-only in Carbon. You should instead use the high-level functions provided by the Window Manager.

Unsupported  LMSetWMgrPort

The Window Manager port is not supported in Carbon.

Supported  LMSetWordRedraw

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

Generated on: 7/7/99. Copyright 1999 Apple Computer, Inc. All rights reserved.