Carbon


DMCanMirrorNow

Header: Displays.h Carbon status: Supported

Determines whether video mirroring can be activated on the user’s computer system.

OSErr DMCanMirrorNow (
    Boolean *canMirrorNow
);
Parameter descriptions
canMirrorNow

A pointer to a Boolean value; true indicates that mirroring can be activated; false indicates it cannot.

function result

A result code.

DISCUSSION

In the value pointed to by the canMirrorNow parameter, the DMCanMirrorNow function reports whether video mirroring can be activated. When the canMirrorNow parameter points to a value of true, then the computer uses a version of QuickDraw that supports video mirroring, has exactly two displays attached, and does not have mirror blocking in effect.

You can use the DMQDIsMirroringCapable function to determine whether the computer uses a version of QuickDraw that supports video mirroring. You can use the DMBlockMirroring function and the DMUnBlockMirroring function to block and unblock video mirroring. To determine whether the user’s computer system currently uses video mirroring, use the DMIsMirroringOn function.

SPECIAL CONSIDERATIONS

The DMCanMirrorNow function may move or purge memory blocks in the application heap. Your application should not call this function at interrupt time.

VERSION NOTES

As of System Software version 7.5, only PowerBook computers support video mirroring.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)