Documentation Archive Developer
Search

ADC Home > Reference Library > Technical Q&As > Legacy Documents > Graphics & Imaging >

Legacy Documentclose button

Important: This document is part of the Legacy section of the ADC Reference Library. This information should not be used for new development.

Current information on this Reference Library topic can be found here:

How to get the Monitor ID as displayed in the Monitors & Sound Control Panel


Q: I am trying to use the Display Manager call DMGetDisplayIDByGDevice() to get the monitor ID as displayed in the Monitors & Sound Control Panel when a user presses the "Identify Monitors" button. Unfortunately, DMGetDisplayIDByGDevice() does not seem to return this value. How do I get the actual monitor ID number?

A: There is a call defined in Displays.h that is not described in the Display Manager documentation that you should use. Essentially, what you want to do is use DMGetDisplayIDByGDevice to get the displayID, and then use the DMGetNameByAVID with that displayID to get the "name" of the device. The "name" is a string containing the device name (e.g., Multiple Scan Display) and the device number (e.g., 1). The device number is the number that appears in the Monitors & Sound Control Panel. To obtain just the device number, or monitor ID, use masks to retrieve just that section of the name. For example:


err = DMGetDisplayIDByGDevice(gd, &displayID, false);
err = DMGetNameByAVID(displayID, kSuppressNameMask + kForceNumberMask, &theStr);

Keep in mind, these calls work with Display Manager 2.0. To use these calls on systems with Display Manager 1.0, you need to ensure that you user has the Display Enabler installed. The Display Enabler is included with the Display Manager SDK. You will find the Display Manager SDK here or on the MacOS SDK CD.

More specifics on the call DMGetNameByAVID To determine the "name" and/or device number of the requested device, use the DMGetNameByAVID function.

extern pascal OSErr DMGetNameByAVID
            (AVIDType theID, unsigned long nameFlags, Str255 *name)
theID AVIDType is an ID for ports and devices. The old Display ID type is carried on for compatibility . Basically, theID is the displayID for the video device whose GDevice record you wish to obtain.

nameFlags
enum {
        /* bits for nameFlags */
        kSuppressNumberBit      = 0,
        kSuppressNumberMask     = 1,
        kForceNumberBit         = 1,
        kForceNumberMask        = 2,
        kSuppressNameBit        = 2,
        kSuppressNameMask       = 4
    };

*name *name is a string containing the device name, i.e.,, Multiple Scan Display and device number, the order for which the device appears in the device tree.

To obtain a section of the "name," use the nameFlags parameter.

To obtain just the name, i.e., Multiple Scan Display, use the flag kSuppressNumberMask in the nameFlags parameter.


     err = DMGetNameByAVID(displayID, kSuppressNumberMask, &nameStr);

To obtain just the number, use the kSuppressNameMask + kForceNumberMask masks.


     err = DMGetNameByAVID(displayID, kSuppressNameMask + kForceNumberMask,
        &numberStr);

To obtain both in the same string, use the kForceNumberMask flag.


     err = DMGetNameByAVID(displayID, kForceNumberMask, &nameStr);
   

[Jan 16 2003]