Carbon


DMMirrorDevices

Header: Displays.h Carbon status: Supported

Turns on video mirroring.

OSErr DMMirrorDevices (
    GDHandle gD1, 
    GDHandle gD2, 
    Handle displayState
);
Parameter descriptions
gD1

A handle to the GDevice structure for the video device whose pixel image you want duplicated on another device.

gD2

A handle to the GDevice structure for the video device on which you want to duplicate the pixel image specified in the gD1 parameter.

displayState

If your application called DMBeginConfigureDisplays, you must pass the displayState handle obtained. Otherwise pass NULL in this parameter.

function result

A result code.

DISCUSSION

Your application should leave control of video mirroring to the user. However, if video mirroring is useful for your application (for example, if your application displays on-screen presentations), you might provide a control so that the user can switch to video mirroring directly from your application. In this case, DMMirrorDevices is useful to your application. Your control should also allow the user to turn video mirroring off; the function DMUnmirrorDevice supports this.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

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)