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);
|
|
