Legacy Document

Inside Macintosh: Devices /

Chapter 6 - Power Manager / Power Manager Reference

Power Manager Dispatch Routines / Controlling the Hard Disk

HardDiskQRemove

You can use the HardDiskQRemove function to discontinue notification of your software when power to the internal hard disk is about to be turned off.

OSErr HardDiskQRemove(HDQueueElement *theElement);

theElement

A pointer to the element for the hard disk power down queue that you wish to remove.

DESCRIPTION

The HardDiskQRemove function removes a queue element installed by HardDiskQInstall. If the hdQType field of the queue element is not set to HDPwrQType, HardDiskQRemove simply returns an error.

ASSEMBLY-LANGUAGE INFORMATION

The trap is _PowerMgrDispatch ($A09E). The selector value for HardDiskQRemove is 11 ($0B) in the low word of register D0. The pointer to the HDQueue element is passed in register A0. The result code is returned in the low word of register D0.

RESULT CODES

noErr

0

No error

SEE ALSO

The HDQueueElement structure is defined in "Hard Disk Queue Structure," on page 6-27.

The application-defined hard disk spindown function is described in "Hard Disk Spindown Function," on page 6-66.