sysinfo
The sysinfo
command retrieves MCI system information. The sysinfo command is an MCI
system command; it is interpreted directly by MCI.
wsprintf(lpstrCommand, "sysinfo %s %s %s",
lpszDeviceID, lpszRequest,
lpszFlags);
Parameters
lpszDeviceID
Identifier of
an MCI device or device type. If a device type is specified, it must be a
standard MCI device-type name, as listed in the reference material for the capability command. You can specify
all when the flag specified in lpszRequest allows that possibility.
lpszRequest
One of the
following flags:
|
installname |
Returns the
name listed in the registry or the SYSTEM.INI file used to install the open
device with the specified device identifier. |
|
quantity |
Returns the
number of MCI devices listed in the registry or the SYSTEM.INI file of the
type specified in the lpszDeviceID parameter. This device identifier
must be a standard MCI device-type name. Any digits after the device type are
ignored. Specifying all for lpszDeviceID returns the total number of
MCI devices in the system. |
|
quantity
open |
Returns the
number of open MCI devices of the type specified in lpszDeviceID. This
device identifier must be a standard MCI device-type name. Specifying all
for lpszDeviceID returns the total number of open MCI devices in the
system. |
|
name index |
Returns the
name of an MCI device. The device identifier must be a standard MCI
device-type name. The index ranges from 1 to the number of devices of
that type. If all is specified for lpszDeviceID, index ranges
from 1 to the total number of devices in the system. |
|
name index
open |
Returns the
name of an open MCI device. The device identifier must be a standard MCI
device-type name. The index ranges from 1 to the number of open
devices of that device type. If all is specified for lpszDeviceID, index
ranges from 1 to the total number of open devices in the system. |
lpszFlags
Can be
wait , notify , or both. For digital-video and VCR devices, test can also
be specified. For more information about these flags, see The Wait, Notify,
and Test Flags.
Return Values
Returns zero
if successful or an error otherwise.
Remarks
The following
command returns the number of open waveform-audio devices:
sysinfo waveaudio quantity open
The following
command returns the name (device alias) of the first open waveform-audio
device:
sysinfo waveaudio name 1 open
See Also