Functions specific to MacOS. More...

Enumerations
enum	ePowerMacType { kUnknown = 0 , kPiltdownMan = 1 , kPCIMachine = 2 , kCommSlotMachine = 3 , kPCIComm2Machine = 4 }
	Type of detected Power Mac. More...

Functions
short BURGER_API	get_version (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Return the version of a GetVolParmsInfoBuffer.

long BURGER_API	get_attributes (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Return the volume attributes of a GetVolParmsInfoBuffer.

char **BURGER_API	get_local_handle (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Return the volume Handle.

uint32_t BURGER_API	get_server_address (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Return the server IPv4 address.

long BURGER_API	get_volume_grade (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Return the volume speed grade.

short BURGER_API	get_foreign_PrivID (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Return the foreign privilege model.

long BURGER_API	get_extended_attributes (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Return the extended volume attributes.

void *BURGER_API	get_device_ID (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Return the device ID.

uint_t BURGER_API	is_network_volume (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is the volume a network drive?

uint_t BURGER_API	has_limit_FCBs (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is the File Control Blocks limited to 8?

uint_t BURGER_API	has_local_WList (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the Finder uses the shared volume handle.

uint_t BURGER_API	has_no_mini_finder (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is the mini finder disabled?

uint_t BURGER_API	has_no_volume_name_edit (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is the volume name locked?

uint_t BURGER_API	has_no_local_sync (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is the modification time controlled by the volume?

uint_t BURGER_API	has_trash_offline (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume zoom to the trash?

uint_t BURGER_API	has_no_switch_to (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Don't switch to launching applications on this volume?

uint_t BURGER_API	has_no_desk_items (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Forbid desktop items on this volume?

uint_t BURGER_API	has_no_boot_blocks (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is booting disabled on this volume?

uint_t BURGER_API	has_access_control (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is AppleTalk File Protocol access interfaces supported?

uint_t BURGER_API	has_no_system_directory (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is the volume missing a System directory?

uint_t BURGER_API	has_external_file_system_volume (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is the volume using an external file system?

uint_t BURGER_API	has_open_deny (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support PBHOpenDeny?

uint_t BURGER_API	has_copy_file (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support PBHCopyFile?

uint_t BURGER_API	has_move_rename (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support PBHMoveRename?

uint_t BURGER_API	has_desktop_manager (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support desktop functions?

uint_t BURGER_API	has_short_name (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support AFP short names?

uint_t BURGER_API	has_folder_lock (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support locked folders?

uint_t BURGER_API	has_personal_access (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Is local file sharing enabled on this volume?

uint_t BURGER_API	has_user_group_list (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does this volume support "Users and Groups"?

uint_t BURGER_API	has_cat_search (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support PBCatSearch?

uint_t BURGER_API	has_file_IDs (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support PBExchangeFiles?

uint_t BURGER_API	has_BTree_manager (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume use BTrees?

uint_t BURGER_API	has_blank_access (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Can folders inherit privileges?

uint_t BURGER_API	has_support_async_requests (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Can async file operations be performed on this volume?

uint_t BURGER_API	has_trash_volume_cache (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume use a Trash cache?

uint_t BURGER_API	has_ejectable (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Can the volume be ejected?

uint_t BURGER_API	has_HFSPlus_APIs (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume driver directly support HFS+?

uint_t BURGER_API	has_FSCatalogSearch (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support FSCatalogSearch?

uint_t BURGER_API	has_FSExchangeObjects (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support FSExchangeObjects?

uint_t BURGER_API	has_2TB_file_support (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support 2 terabyte files?

uint_t BURGER_API	has_long_filenames (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support filenames longer than 31 characters?

uint_t BURGER_API	has_multiple_script_names (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support Unicode?

uint_t BURGER_API	has_named_forks (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support named forks?

uint_t BURGER_API	has_subtree_iterators (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support recursive iterators?

uint_t BURGER_API	has_large_to_physical_blocks (const GetVolParmsInfoBuffer *pVolParamsInfoBuffer) BURGER_NOEXCEPT
	Does the volume support Lg2Phys SPI correctly.

int BURGER_API	get_volume_parms (GetVolParmsInfoBuffer pOutput, uint32_t pOutputLength, short sVRefNum) BURGER_NOEXCEPT
	Obtain information from a drive volume.

uint64_t	PollRTC601 (void) BURGER_NOEXCEPT
	Poll the PowerPC 601 Real Time Clock register.

uint64_t	PollTBR603 (void) BURGER_NOEXCEPT
	Poll the PowerPC 603 timer register.

int16_t BURGER_API	get_FSSpec_nth_desc (AEDesc pList, long iIndex, FSSpec pFSSpec) BURGER_NOEXCEPT
	Pull an FSSpec from an AppleEvent.

uint_t BURGER_API	is_trap_available (uint_t uTrapNum) BURGER_NOEXCEPT
	Detect if a MacOS trap number exists.

void BURGER_API	kill_process (ProcessSerialNumber *pVictim) BURGER_NOEXCEPT
	Send a "Quit" event to the requested process.

void BURGER_API	kill_other_processes (void) BURGER_NOEXCEPT
	Send a "Quit" event to every other process.

ePowerMacType BURGER_API	get_power_mac_type (void) BURGER_NOEXCEPT
	Determine class of Power Mac.

uint32_t BURGER_API	get_quickdraw_version (void) BURGER_NOEXCEPT
	Return the version of Quickdraw.

uint_t BURGER_API	has_quicktime_power_plug (void) BURGER_NOEXCEPT
	Detect if the PowerPC native version of Quicktime is present.

uint_t BURGER_API	has_color_quickdraw (void) BURGER_NOEXCEPT
	Test for color Quickdraw.

uint_t BURGER_API	is_color_grafport (const GrafPort *pInput) BURGER_NOEXCEPT
	Test for color GrafPort.

uint32_t BURGER_API	get_appleshare_version (void) BURGER_NOEXCEPT
	Return the version of AppleShare library.

uint32_t BURGER_API	get_nav_services_version (void) BURGER_NOEXCEPT
	Get the version of NavServices.

uint32_t BURGER_API	get_os_version (void) BURGER_NOEXCEPT
	Return the version of MacOS.

uint32_t BURGER_API	get_quicktime_version (void) BURGER_NOEXCEPT
	Return the version of QuickTime.

uint_t BURGER_API	is_running_osx (void) BURGER_NOEXCEPT
	Test if the application is running under MacOSX.

uint32_t BURGER_API	get_control_strip_version (void) BURGER_NOEXCEPT
	Get the version of ControlStrip.

uint32_t BURGER_API	get_input_sprocket_version (void) BURGER_NOEXCEPT
	Return the version of InputSprocket.

uint32_t BURGER_API	get_draw_sprocket_version (void) BURGER_NOEXCEPT
	Return the version of DrawSprocket.

uint32_t BURGER_API	get_sound_manager_version (void) BURGER_NOEXCEPT
	Return the version of the Sound Manager.

uint_t BURGER_API	start_draw_sprocket (void) BURGER_NOEXCEPT
	Start DrawSprocket.

void BURGER_API	stop_draw_sprocket (void) BURGER_NOEXCEPT
	Shut down DrawSprocket.

uint_t BURGER_API	is_user_owner (int8_t ioACUser) BURGER_NOEXCEPT
	Does the logged in use have ownership of this directory?

uint_t BURGER_API	user_has_full_access (int8_t ioACUser) BURGER_NOEXCEPT
	Does the logged in use have full access to this directory?

uint_t BURGER_API	user_has_drop_box_access (int8_t ioACUser) BURGER_NOEXCEPT
	Is the directory a drop box?

uint_t BURGER_API	user_has_change_access (int8_t ioACUser) BURGER_NOEXCEPT
	Can the contents of the directory be changed?

uint_t BURGER_API	user_has_no_access (int8_t ioACUser) BURGER_NOEXCEPT
	Is the user denied access to this directory?

uint_t BURGER_API	has_GetDeviceList (void) BURGER_NOEXCEPT
	Check for the existence of the function GetDeviceList()

uint_t BURGER_API	is_gamma_available (void) BURGER_NOEXCEPT
	Check if gamma fade is available on this machine.

uint_t BURGER_API	is_gamma_available (GDevice **ppGDevice) BURGER_NOEXCEPT
	Check if gamma fade is available on this device.

eError BURGER_API	get_gamma_table (GDevice ppGDevice, GammaTbl ppTable) BURGER_NOEXCEPT
	Check if gamma fade is available on this device.

eError BURGER_API	set_gamma_table (GDevice ppGDevice, const GammaTbl ppTable) BURGER_NOEXCEPT

int32_t BURGER_API	gamma_init (void) BURGER_NOEXCEPT

int32_t BURGER_API	gamma_shutdown (void) BURGER_NOEXCEPT

int32_t	DoGammaFade (short percent)

int32_t	DoOneGammaFade (GDevice **theGDevice, short percent)

Detailed Description

Functions specific to MacOS.

For MacOS 7.5 to 9.2.2, these functions exists to support the operating system.

While modern MacOS shares the same name with classic MacOS, they are not compatible. Use the MacOSX class of functions.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

See also: Burger::MacOSX, or Burger::iOS

Enumeration Type Documentation

◆ ePowerMacType

enum Burger::MacOS::ePowerMacType

Type of detected Power Mac.

The function get_power_mac_type() checks the mac if it's a specific type of Power Macintosh and returns this enumeration so a higher level function can make assumptions about the built-in hardware available on the motherboard.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

See also: get_power_mac_type()

Enumerator
kUnknown	Unknown machine.
kPiltdownMan	Piltdown Man Power Mac.
kPCIMachine	PCI slot Power Mac.
kCommSlotMachine	Communication slot Power Mac.
kPCIComm2Machine	Communication slot 2 w/PCI Power Mac.

Function Documentation

◆ DoGammaFade()

int32_t Burger::MacOS::DoGammaFade ( short percent )

extern

◆ DoOneGammaFade()

int32_t Burger::MacOS::DoOneGammaFade	(	GDevice **	theGDevice,
		short	percent )

extern

◆ gamma_init()

int32_t BURGER_API Burger::MacOS::gamma_init ( void )

extern

◆ gamma_shutdown()

int32_t BURGER_API Burger::MacOS::gamma_shutdown ( void )

extern

◆ get_appleshare_version()

uint32_t BURGER_API Burger::MacOS::get_appleshare_version ( void )

extern

Return the version of AppleShare library.

Ask the AppleShare library what version it is and return that value. The function caches the value so subsequent calls do not ask AppleShare for the version again.

Returns: Version in the format of 0x0102 -> 1.2

Note: If the AppleShare library is not installed, it will return 0.

◆ get_attributes()

long BURGER_API Burger::MacOS::get_attributes ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Return the volume attributes of a GetVolParmsInfoBuffer.

Obtain the volume attribute bits.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: Volume attribute bits.

◆ get_control_strip_version()

uint32_t BURGER_API Burger::MacOS::get_control_strip_version ( void )

extern

Get the version of ControlStrip.

Ask ControlStrip if it exists and return the version.

Returns: 32 bit version number or 0 if NavServices is not available.

◆ get_device_ID()

void *BURGER_API Burger::MacOS::get_device_ID ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Return the device ID.

Device name for use with IOKit. If the GetVolParmsInfoBuffer record is less than version 4, this function will return nullptr.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: Device ID or nullptr if not supported.

◆ get_draw_sprocket_version()

uint32_t BURGER_API Burger::MacOS::get_draw_sprocket_version ( void )

extern

Return the version of DrawSprocket.

Detect if DrawSprocket is available, and if so, query it for the version present. If DrawSprocket is not available, the version returned is zero.

This function is written so it only asks for the version once from DrawSprocket. It will cache the version and return the cached value on subsequent calls.

DSpGetVersion() only appeared in version 1.7 or later and as a result, to get the version from earlier versions the version resource found in the library itself must be opened and read. Because of this, the first call to this function may take some time.

Returns: Version in the format of 0x0102 -> 1.2

Note: This code only works on CFM versions of Mac Classic applications. Non-CFM 68k targets will always return 0.

◆ get_extended_attributes()

long BURGER_API Burger::MacOS::get_extended_attributes ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Return the extended volume attributes.

Most volumes support extended attributes that denote if the volume can be ejected, max size, and other details. If the GetVolParmsInfoBuffer record is less than version 3, this function will return 0.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: Volume extended attributes or 0 if not supported.

◆ get_foreign_PrivID()

short BURGER_API Burger::MacOS::get_foreign_PrivID ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Return the foreign privilege model.

Volumes may have additional privileges models, this value is 0 for HFS volumes which may or may not support AFP, fsUnixPriv if it supports A/UX. If the version is less than 2, return 0.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: Volume privilege ID, or zero if unknown.

◆ get_FSSpec_nth_desc()

int16_t BURGER_API Burger::MacOS::get_FSSpec_nth_desc	(	AEDesc *	pList,
		long	iIndex,
		FSSpec *	pFSSpec )

extern

Pull an FSSpec from an AppleEvent.

Given an AppleEvent, index into it and extract an FSSpec. The index is passed to the MacOS function AEGetNthDesc().

Parameters

pList	AEDescList pointer of a list of AppleEvents to process
iIndex	Entry index into the list.
pFSSpec	Pointer to the FSSpec record to receive the file reference.

Returns: OSErr of 0 for no error on non-zero OSErr.

◆ get_gamma_table()

Burger::eError BURGER_API Burger::MacOS::get_gamma_table	(	GDevice **	ppGDevice,
		GammaTbl **	ppTable )

extern

Check if gamma fade is available on this device.

Determine if this video device supports

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Returns: TRUE if gamma is allowed, FALSE if not.

See also: is_gamma_available()

◆ get_input_sprocket_version()

uint32_t BURGER_API Burger::MacOS::get_input_sprocket_version ( void )

extern

Return the version of InputSprocket.

Detect if InputSprocket is available, and if so, query it for the version present. If InputSprocket is not available, the version returned is zero.

This function is written so it only asks for the version once from InputSprocket. It will cache the version and return the cached value on subsequent calls.

Returns: Version in the format of 0x0102 -> 1.2

Note: This code only works on CFM versions of Mac Classic applications. Non-CFM 68k targets will always return 0.

◆ get_local_handle()

Handle BURGER_API Burger::MacOS::get_local_handle ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Return the volume Handle.

Obtain the Handle of the volume driver data. USE AT YOUR OWN RISK!

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: Volume driver local data Handle.

◆ get_nav_services_version()

uint32_t BURGER_API Burger::MacOS::get_nav_services_version ( void )

extern

Get the version of NavServices.

Ask NavServices if it exists and return the version.

Returns: 32 bit version number or 0 if NavServices is not available.

◆ get_os_version()

uint32_t BURGER_API Burger::MacOS::get_os_version ( void )

extern

Return the version of MacOS.

Ask MacOS what version it is and return that value.

Returns: Version in the format of 0x0102 -> 1.2

◆ get_power_mac_type()

Burger::MacOS::ePowerMacType BURGER_API Burger::MacOS::get_power_mac_type ( void )

extern

Determine class of Power Mac.

Using Gestalt(), determine the type of Power Mac the code is running on. This is useful in determining the presence of a built-in ethernet port.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Returns: Mac::ePowerMacType enumeration. ePowerMacType::kUnknown if not a Power Mac.

◆ get_quickdraw_version()

uint32_t BURGER_API Burger::MacOS::get_quickdraw_version ( void )

extern

Return the version of Quickdraw.

Use Gestalt to test for what version of Quickdraw is available.

Returns: Version in the format of 0x0102 -> 1.2

◆ get_quicktime_version()

uint32_t BURGER_API Burger::MacOS::get_quicktime_version ( void )

extern

Return the version of QuickTime.

Detect if QuickTime is available, and if so, query it for the version present. If QuickTime is not available, the version returned is zero.

This function is written so it only asks for the version once from QuickTime. It will cache the version and return the cached value on subsequent calls.

Returns: Version in the format of 0x0102 -> 1.2

◆ get_server_address()

uint32_t BURGER_API Burger::MacOS::get_server_address ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Return the server IPv4 address.

If the volume is a mounted network server, the IPv4 address can be obtained from this function. If the value is zero, then this is a locally mounted block device. Firewire, Floppy, USB and IDE drives will return zero.

Note: If it's an AppleTalk volume, it may also be an AppleTalk address; This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: IPv4 address of network shared volume, or zero.

◆ get_sound_manager_version()

uint32_t BURGER_API Burger::MacOS::get_sound_manager_version ( void )

extern

Return the version of the Sound Manager.

Ask the MacOS Sound Manager what version it is and return that value. The function caches the value so subsequent calls do not ask the Sound Manager for the version again.

Returns: Version in the format of 0x0102 -> 1.2

Note: If the sound manager is not installed (Very old mac models), it will return 0.

Sound manager version in 0x0102 (1.2) format (Mac only)

◆ get_version()

short BURGER_API Burger::MacOS::get_version ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Return the version of a GetVolParmsInfoBuffer.

Depending on the version of MacOS the application is running, and the device driver found for the mounted drive, it will support levels of information. This accessor will return the version of the GetVolParmsInfoBuffer buffer so the application will know what levels of data are present.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: Version of the GetVolParmsInfoBuffer (0 through 3)

◆ get_volume_grade()

long BURGER_API Burger::MacOS::get_volume_grade ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Return the volume speed grade.

If the speed class of a volume is known, return that value. Higher is better. If the speed is unknown or if the version is less than 2, return 0.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: Speed grade of volume, or zero if unknown.

◆ get_volume_parms()

int BURGER_API Burger::MacOS::get_volume_parms	(	GetVolParmsInfoBuffer *	pOutput,
		uint32_t *	pOutputLength,
		short	sVRefNum )

extern

Obtain information from a drive volume.

Call PBHGetVolParmsSync() and fill in a supplied GetVolParmsInfoBuffer record. Pass in a pointer to a uint32_t that has the size, in bytes, of the GetVolParmsInfoBuffer structure and the function will replace the value with the actual transferred buffer size.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pOutput	Pointer to an uninitialized GetVolParmsInfoBuffer buffer
pOutputLength	Pointer to a value that contains the size, in bytes, of the GetVolParmsInfoBuffer. Will return the actual size filled in.
sVRefNum	Volume reference number of the volume to get information from.

Returns: Zero if no error, or mac error code

◆ has_2TB_file_support()

uint_t BURGER_API Burger::MacOS::has_2TB_file_support ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support 2 terabyte files?

Does the volume support files as large as 2 terabytes? Return TRUE if true.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports 2 TB files, FALSE if not.

◆ has_access_control()

uint_t BURGER_API Burger::MacOS::has_access_control ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is AppleTalk File Protocol access interfaces supported?

If the volume supports AppleTalk File Protocol, this accessor will return TRUE. Calls to PBHGetLoginInfo, PBHGetDirAccess, PBHSetDirAccess,PBHMapID, and PBHMapName will succeed.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supported AFP, FALSE if not.

◆ has_blank_access()

uint_t BURGER_API Burger::MacOS::has_blank_access ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Can folders inherit privileges?

Does the volume support privilege inheritance? If so, return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume allows access privilege inheritance, FALSE if not.

◆ has_BTree_manager()

uint_t BURGER_API Burger::MacOS::has_BTree_manager ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume use BTrees?

Does the volume use BTrees? This is TRUE on local volume formatted with HFS. If the volume is formatted with a different file system, this will return FALSE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume uses BTrees, FALSE if not.

◆ has_cat_search()

uint_t BURGER_API Burger::MacOS::has_cat_search ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support PBCatSearch?

Does the volume support the call PBCatSearch? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports PBCatSearch, FALSE if not.

◆ has_color_quickdraw()

uint_t BURGER_API Burger::MacOS::has_color_quickdraw ( void )

extern

Test for color Quickdraw.

Check the version of quickdraw and if color is supported, return TRUE.

Returns: TRUE if color is supported.

◆ has_copy_file()

uint_t BURGER_API Burger::MacOS::has_copy_file ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support PBHCopyFile?

Does the volume support the call PBHCopyFile? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports PBHCopyFile, FALSE if not.

◆ has_desktop_manager()

uint_t BURGER_API Burger::MacOS::has_desktop_manager ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support desktop functions?

Does the volume support all of the desktop functions for the Desktop Manager? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports Desktop Manager, FALSE if not.

◆ has_ejectable()

uint_t BURGER_API Burger::MacOS::has_ejectable ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Can the volume be ejected?

If the volume can be unmounted, return TRUE. This is especially true for USB and CD/DVD/BluRay drives.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume can be ejected, FALSE if not.

◆ has_external_file_system_volume()

uint_t BURGER_API Burger::MacOS::has_external_file_system_volume ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is the volume using an external file system?

This volume is managed remotely or within a device and not from the local file manager if this returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume file system is controlled by an external device, FALSE if it's managed locally.

◆ has_file_IDs()

uint_t BURGER_API Burger::MacOS::has_file_IDs ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support PBExchangeFiles?

Does the volume support the call PBExchangeFiles and file ID functions? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports PBExchangeFiles, FALSE if not.

◆ has_folder_lock()

uint_t BURGER_API Burger::MacOS::has_folder_lock ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support locked folders?

Does the volume support attribute bits on folders so they can be locked? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports folder locking, FALSE if not.

◆ has_FSCatalogSearch()

uint_t BURGER_API Burger::MacOS::has_FSCatalogSearch ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support FSCatalogSearch?

Does the volume support the call FSCatalogSearch and file ID functions? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports FSCatalogSearch, FALSE if not.

◆ has_FSExchangeObjects()

uint_t BURGER_API Burger::MacOS::has_FSExchangeObjects ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support FSExchangeObjects?

Does the volume support the call FSExchangeObjects and file ID functions? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports FSExchangeObjects, FALSE if not.

◆ has_GetDeviceList()

uint_t BURGER_API Burger::MacOS::has_GetDeviceList ( void )

extern

Check for the existence of the function GetDeviceList()

Check the 68000 traps to see if the MacOS function GetDeviceList() exists.

Carbon will always return TRUE

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Returns: TRUE if GetDeviceList() is present, FALSE if not.

◆ has_HFSPlus_APIs()

uint_t BURGER_API Burger::MacOS::has_HFSPlus_APIs ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume driver directly support HFS+?

If the volume driver supports the HFS+ API, return TRUE. Otherwise the Mac File Manager will emulate them. If a volume supports the HFS+ APIs doesn't mean it's formatted with HFS+.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume support HFS+ APIs, FALSE if not.

◆ has_large_to_physical_blocks()

uint_t BURGER_API Burger::MacOS::has_large_to_physical_blocks ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support Lg2Phys SPI correctly.

The volume supports Lg2Phys correctly if this returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports Lg2Phys, FALSE if not.

◆ has_limit_FCBs()

uint_t BURGER_API Burger::MacOS::has_limit_FCBs ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is the File Control Blocks limited to 8?

Test if the volume uses only 8 control blocks instead of 16.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if it limits FCBs, FALSE if local.

◆ has_local_WList()

uint_t BURGER_API Burger::MacOS::has_local_WList ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the Finder uses the shared volume handle.

Test if the Finder uses the shared volume handle for its local window list.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the Finder uses the handle, FALSE if local.

◆ has_long_filenames()

uint_t BURGER_API Burger::MacOS::has_long_filenames ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support filenames longer than 31 characters?

Does the volume support filenames longer than 31 characters? Return TRUE if true.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports long filenames, FALSE if not.

◆ has_move_rename()

uint_t BURGER_API Burger::MacOS::has_move_rename ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support PBHMoveRename?

Does the volume support the call PBHMoveRename? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports PBHMoveRename, FALSE if not.

◆ has_multiple_script_names()

uint_t BURGER_API Burger::MacOS::has_multiple_script_names ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support Unicode?

Does the volume support Unicode so it can handle multiple languages? Return TRUE if true.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports Unicode, FALSE if not.

◆ has_named_forks()

uint_t BURGER_API Burger::MacOS::has_named_forks ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support named forks?

The mac uses a file system with two forks, a data fork and a resource fork. If the volume supports forks beyond that, they have names. The default is none for the data fork, and "RESOURCE_FORK" for the resource fork. If alternate forks are supported, this accessor will return TRUE.

Does the volume support Unicode so it can handle multiple languages? Return TRUE if true.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports more than two forks, FALSE if not.

◆ has_no_boot_blocks()

uint_t BURGER_API Burger::MacOS::has_no_boot_blocks ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is booting disabled on this volume?

If the volume does not have boot blocks, return TRUE. Boot blocks are required to boot into classic MacOS. The Control Panel will dim the icon for this drive for startup if this bit is set.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume cannot be booted, FALSE if bootable.

◆ has_no_desk_items()

uint_t BURGER_API Burger::MacOS::has_no_desk_items ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Forbid desktop items on this volume?

If the volume forbids placing items on the desktop, this accessor will return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the desktop folder is not supported on this volume, FALSE if permitted.

◆ has_no_local_sync()

uint_t BURGER_API Burger::MacOS::has_no_local_sync ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is the modification time controlled by the volume?

Test if the volume modification times is managed by the volume. Network drives tend to manage the file creation/modification times, so if this returns TRUE, all requests to alter the time codes will fail.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume manages time codes, FALSE if the codes can be locally changed.

◆ has_no_mini_finder()

uint_t BURGER_API Burger::MacOS::has_no_mini_finder ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is the mini finder disabled?

Burgerlib requires a minimum of MacOS 7.5 or higher, so this will always return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the mini Finder is disabled, FALSE if available.

◆ has_no_switch_to()

uint_t BURGER_API Burger::MacOS::has_no_switch_to ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Don't switch to launching applications on this volume?

If the volume forbids launching applications from it, this accessor will return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if applications shouldn't launch from this volume, FALSE if permitted.

◆ has_no_system_directory()

uint_t BURGER_API Burger::MacOS::has_no_system_directory ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is the volume missing a System directory?

This volume doesn't support a System directory. Do not switch launch to this volume if TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume don't support a System directory, FALSE if it does.

◆ has_no_volume_name_edit()

uint_t BURGER_API Burger::MacOS::has_no_volume_name_edit ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is the volume name locked?

Test if the volume name can be changed. Locked and network volumes cannot be altered, so they will return TRUE. Local drives almost always return FALSE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume name is immutable, FALSE if is can be changed.

◆ has_open_deny()

uint_t BURGER_API Burger::MacOS::has_open_deny ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support PBHOpenDeny?

Does the volume support the calls PBHOpenDeny and PBHOpenRFDeny? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports PBHOpenDeny, FALSE if not.

◆ has_personal_access()

uint_t BURGER_API Burger::MacOS::has_personal_access ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is local file sharing enabled on this volume?

If this volume is being shared, return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if file sharing is enabled on this volume, FALSE if not.

◆ has_quicktime_power_plug()

uint_t BURGER_API Burger::MacOS::has_quicktime_power_plug ( void )

extern

Detect if the PowerPC native version of Quicktime is present.

Detect if the PowerPC native extension of Quicktime is loaded and available. This is only for Quicktime version 2.5 during the initial transition from 680x0 to PowerPC. It's almost certainly going to return TRUE on PowerPC systems. Only in very rare cases of Quicktime 2.5 where it's emulated in 680x0 code (And therefore a performance bottleneck) in which this matters.

This function is written so it only does the detection once and it caches the result. The cached value is returned on subsequent calls.

Returns: TRUE if Quicktime is running in PowerPC code, FALSE if emulated 680x0.

Note: This code always returns FALSE on non-PowerPC targets.

◆ has_short_name()

uint_t BURGER_API Burger::MacOS::has_short_name ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support AFP short names?

Does the volume support AppleTalk File Protocol short names? If so, it returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports AFP short names, FALSE if not.

◆ has_subtree_iterators()

uint_t BURGER_API Burger::MacOS::has_subtree_iterators ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume support recursive iterators?

The volume supports recursive iterators, not at the volume root if this returns TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports recursive iterators, FALSE if not.

◆ has_support_async_requests()

uint_t BURGER_API Burger::MacOS::has_support_async_requests ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Can async file operations be performed on this volume?

Does the volume support asynchronous file operations properly? Return TRUE if true.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume supports asynchronous file operations, FALSE if not.

◆ has_trash_offline()

uint_t BURGER_API Burger::MacOS::has_trash_offline ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume zoom to the trash?

If this volume is unmounted, should the Finder show a "zoom" to the trash?

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume should make a visual effect, FALSE if not.

◆ has_trash_volume_cache()

uint_t BURGER_API Burger::MacOS::has_trash_volume_cache ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does the volume use a Trash cache?

Mac OS X doesn't support Trash attributes and simulates the behavior by using a hidden folder. If this is being used, return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume uses a trash cache, FALSE if not.

◆ has_user_group_list()

uint_t BURGER_API Burger::MacOS::has_user_group_list ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Does this volume support "Users and Groups"?

If this volume is either on MacOS X, or on a network volume that supports user level privilege access, return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if the volume support user level access FALSE if not.

◆ is_color_grafport()

uint_t BURGER_API Burger::MacOS::is_color_grafport ( const GrafPort * pInput )

extern

Test for color GrafPort.

Check the version of the GrafPort and if color is supported, return TRUE.

Returns: TRUE if the GrafPort is really a CGrafPort.

◆ is_gamma_available() [1/2]

uint_t BURGER_API Burger::MacOS::is_gamma_available ( GDevice ** ppGDevice )

extern

Check if gamma fade is available on this device.

Determine if this video device supports

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Returns: TRUE if gamma is allowed, FALSE if not.

See also: is_gamma_available()

◆ is_gamma_available() [2/2]

uint_t BURGER_API Burger::MacOS::is_gamma_available ( void )

extern

Check if gamma fade is available on this machine.

Iterate among all the attached monitors and determine if all of them have the ability to perform a gamma fade. If any monitors cannot gamma fade, return FALSE

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Returns: TRUE if gamma is allowed, FALSE if not.

See also: is_gamma_available(GDevice**)

◆ is_network_volume()

uint_t BURGER_API Burger::MacOS::is_network_volume ( const GetVolParmsInfoBuffer * pVolParamsInfoBuffer )

extern

Is the volume a network drive?

Test if the volume is a shared drive accessed by a network.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVolParamsInfoBuffer Pointer to a valid GetVolParmsInfoBuffer

Returns: TRUE if it's a remote drive, FALSE if local.

◆ is_running_osx()

uint_t BURGER_API Burger::MacOS::is_running_osx ( void )

extern

Test if the application is running under MacOSX.

Ask MacOS what version it is and if it's 10.0 or higher, return TRUE

Returns: TRUE if running under MacOSX, FALSE if MacOS 9 or earlier

◆ is_trap_available()

uint_t BURGER_API Burger::MacOS::is_trap_available ( uint_t uTrapNum )

extern

Detect if a MacOS trap number exists.

Detect if a specific 680x0 trap instruction is present.

Due to the nature of this function, caching is impractical and it is not performed. This function is considered a performance bottleneck and should be called sparingly.

Note: This is a MacOS Classic function. It always returns FALSE on Carbon targets.

Parameters

uTrapNum A valid MacOS 680x0 trap number from Traps.h.

Returns: TRUE if the requested trap index is present, FALSE if not.

◆ is_user_owner()

uint_t BURGER_API Burger::MacOS::is_user_owner ( int8_t ioACUser )

extern

Does the logged in use have ownership of this directory?

The directory is owned by the currently logged in user, return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

ioACUser ioACUser value from a valid DirInfo structure.

Returns: TRUE if the directory is owned by the user, FALSE if not.

◆ kill_other_processes()

void BURGER_API Burger::MacOS::kill_other_processes ( void )

extern

Send a "Quit" event to every other process.

Send a "Quit" event to every other app however, don't kill myself and kill the finder last

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

◆ kill_process()

void BURGER_API Burger::MacOS::kill_process ( ProcessSerialNumber * pVictim )

extern

Send a "Quit" event to the requested process.

Send an Apple Event to the process to tell the process to properly quit.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

pVictim Pointer to a process serial number of the process to kill

◆ PollRTC601()

Burger::MacOS::PollRTC601 ( void )

extern

Poll the PowerPC 601 Real Time Clock register.

Poll the PowerPC 601 Real Time Clock register and debounce the value. Once debounced, return the 64 bit value.

Done in assembly, because that's how you know it's done right

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Returns: 64 bit Real Time Clock register

◆ PollTBR603()

Burger::MacOS::PollTBR603 ( void )

extern

Poll the PowerPC 603 timer register.

Poll the PowerPC 603 Time Base Register and debounce the value. Once debounced, return the 64 bit value.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Returns: 64 bit Time Base Register

◆ set_gamma_table()

eError BURGER_API Burger::MacOS::set_gamma_table	(	GDevice **	ppGDevice,
		const GammaTbl **	ppTable )

extern

◆ start_draw_sprocket()

uint_t BURGER_API Burger::MacOS::start_draw_sprocket ( void )

extern

Start DrawSprocket.

If DrawSprocket was not started, test for its existance and initialize the library. If DrawSprocket was started successfully or was already started, return TRUE, otherwise return FALSE

Note: This call does nothing on non-CFM targets

Returns: TRUE on success

◆ stop_draw_sprocket()

void BURGER_API Burger::MacOS::stop_draw_sprocket ( void )

extern

Shut down DrawSprocket.

If DrawSprocket was started, shut it down.

Note: This call does nothing on non-CFM targets

◆ user_has_change_access()

uint_t BURGER_API Burger::MacOS::user_has_change_access ( int8_t ioACUser )

extern

Can the contents of the directory be changed?

If the user has access to make changes in the directory, return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

ioACUser ioACUser value from a valid DirInfo structure.

Returns: TRUE if the user has modification access to a directory, FALSE if not.

◆ user_has_drop_box_access()

uint_t BURGER_API Burger::MacOS::user_has_drop_box_access ( int8_t ioACUser )

extern

Is the directory a drop box?

Drop box folders allow operations like copying into the directory. But it doesn't allow viewing of the files and folders within. Check the directory attributes if the directory is a drop box. Return TRUE if so.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

ioACUser ioACUser value from a valid DirInfo structure.

Returns: TRUE if the directory is a drop box, FALSE if not.

◆ user_has_full_access()

uint_t BURGER_API Burger::MacOS::user_has_full_access ( int8_t ioACUser )

extern

Does the logged in use have full access to this directory?

If the user has full access to this directory, return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

ioACUser ioACUser value from a valid DirInfo structure.

Returns: TRUE if user has full directory access, FALSE if not.

◆ user_has_no_access()

uint_t BURGER_API Burger::MacOS::user_has_no_access ( int8_t ioACUser )

extern

Is the user denied access to this directory?

If the user has no access to this directory, return TRUE.

Note: This is only available on Mac OS 7.5-9.9.2 or Carbon

Parameters

ioACUser ioACUser value from a valid DirInfo structure.

Returns: TRUE if the user has no access to a directory, FALSE if not.

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

◆ ePowerMacType

Function Documentation

◆ DoGammaFade()

◆ DoOneGammaFade()

◆ gamma_init()

◆ gamma_shutdown()

◆ get_appleshare_version()

◆ get_attributes()

◆ get_control_strip_version()

◆ get_device_ID()

◆ get_draw_sprocket_version()

◆ get_extended_attributes()

◆ get_foreign_PrivID()

◆ get_FSSpec_nth_desc()

◆ get_gamma_table()

◆ get_input_sprocket_version()

◆ get_local_handle()

◆ get_nav_services_version()

◆ get_os_version()

◆ get_power_mac_type()

◆ get_quickdraw_version()

◆ get_quicktime_version()

◆ get_server_address()

◆ get_sound_manager_version()

◆ get_version()

◆ get_volume_grade()

◆ get_volume_parms()

◆ has_2TB_file_support()

◆ has_access_control()

◆ has_blank_access()

◆ has_BTree_manager()

◆ has_cat_search()

◆ has_color_quickdraw()

◆ has_copy_file()

◆ has_desktop_manager()

◆ has_ejectable()

◆ has_external_file_system_volume()

◆ has_file_IDs()

◆ has_folder_lock()

◆ has_FSCatalogSearch()

◆ has_FSExchangeObjects()

◆ has_GetDeviceList()

◆ has_HFSPlus_APIs()

◆ has_large_to_physical_blocks()

◆ has_limit_FCBs()

◆ has_local_WList()

◆ has_long_filenames()

◆ has_move_rename()

◆ has_multiple_script_names()

◆ has_named_forks()

◆ has_no_boot_blocks()

◆ has_no_desk_items()

◆ has_no_local_sync()

◆ has_no_mini_finder()

◆ has_no_switch_to()

◆ has_no_system_directory()

◆ has_no_volume_name_edit()

◆ has_open_deny()

◆ has_personal_access()

◆ has_quicktime_power_plug()

◆ has_short_name()

◆ has_subtree_iterators()

◆ has_support_async_requests()

◆ has_trash_offline()

◆ has_trash_volume_cache()

◆ has_user_group_list()

◆ is_color_grafport()

◆ is_gamma_available() [1/2]

◆ is_gamma_available() [2/2]

◆ is_network_volume()

◆ is_running_osx()

◆ is_trap_available()

◆ is_user_owner()

◆ kill_other_processes()

◆ kill_process()

◆ PollRTC601()