MCI_SYSINFO command
The MCI_SYSINFO command retrieves information about MCI devices. MCI supports this command directly rather than passing it to the device. Any MCI application can use this command. String information is returned in the application-supplied buffer pointed to by the lpstrReturn member of the structure identified by lpSysInfo. Numeric information is returned as a DWORD value placed in the application-supplied buffer. The dwRetSize member specifies the buffer length.
To send this command, call the mciSendCommand function with the following parameters.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SYSINFO,
DWORD dwFlags,
(DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);
Parameters
-
wDeviceID
-
Device identifier of the MCI device that is to receive the command message.
-
dwFlags
-
One or more of the following standard and command-specific flags:
-
MCI_SYSINFO_INSTALLNAME
-
Obtains the name (listed in the registry or the SYSTEM.INI file) used to install the device.
-
MCI_SYSINFO_NAME
-
Obtains a device name corresponding to the device number specified in the dwNumber member of the structure identified bylpSysInfo. If the MCI_SYSINFO_OPEN flag is set, MCI returns the names of open devices.
-
MCI_SYSINFO_OPEN
-
Obtains the quantity or name of open devices.
-
MCI_SYSINFO_QUANTITY
-
Obtains the number of devices of the specified type that are listed in the registry or the [mci] section of the SYSTEM.INI file. If the MCI_SYSINFO_OPEN flag is set, the number of open devices is returned.
-
lpSysInfo
-
Pointer to an MCI_SYSINFO_PARMS structure.
Return Value
Returns zero if successful or an error otherwise.
Remarks
The wDeviceType member of the structure identified by lpSysInfo is used to indicate the device type of the query. If the wDeviceID parameter is set to MCI_ALL_DEVICE_ID, it overrides the value of wDeviceType. For a list of device types, see MCI Device Types.
Integer return values are DWORD values returned in the buffer pointed to by the lpstrReturn member of the structure identified by lpSysInfo.
String return values are null-terminated strings returned in the buffer pointed to by the lpstrReturn member of the structure identified by lpSysInfo.
Requirements
Requirement | Value |
---|---|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
Minimum supported server |
Windows 2000 Server [desktop apps only] |
Header |
|