команда MCI_SYSINFO
Команда MCI_SYSINFO извлекает сведения об устройствах MCI. MCI поддерживает эту команду напрямую, а не передает ее на устройство. Эту команду может использовать любое приложение MCI. Строковые сведения возвращаются в буфере, предоставленном приложением, на который указывает элемент lpstrReturn структуры, определяемой lpSysInfo. Числовые сведения возвращаются в виде значения DWORD , помещенного в буфер, предоставленный приложением. Элемент dwRetSize указывает длину буфера.
Чтобы отправить эту команду, вызовите функцию mciSendCommand со следующими параметрами.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SYSINFO,
DWORD dwFlags,
(DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);
Параметры
-
wDeviceID
-
Идентификатор устройства MCI, которое будет получать сообщение команды.
-
Dwflags
-
Один или несколько из следующих стандартных флагов и флагов, относящихся к командам:
-
MCI_SYSINFO_INSTALLNAME
-
Получает имя (указанное в реестре или файле SYSTEM.INI), используемое для установки устройства.
-
MCI_SYSINFO_NAME
-
Получает имя устройства, соответствующее номеру устройства, указанному в элементе dwNumber структуры, определяемойlpSysInfo. Если установлен флаг MCI_SYSINFO_OPEN, MCI возвращает имена открытых устройств.
-
MCI_SYSINFO_OPEN
-
Получает количество или имя открытых устройств.
-
MCI_SYSINFO_QUANTITY
-
Получает количество устройств указанного типа, перечисленных в реестре или разделе [mci] файла SYSTEM.INI. Если установлен флаг MCI_SYSINFO_OPEN, возвращается количество открытых устройств.
-
lpSysInfo
-
Указатель на структуру MCI_SYSINFO_PARMS .
Возвращаемое значение
Возвращает ноль при успешном выполнении или ошибке в противном случае.
Комментарии
Элемент wDeviceType структуры, определяемой lpSysInfo , используется для указания типа устройства запроса. Если параметр wDeviceID имеет значение MCI_ALL_DEVICE_ID, он переопределяет значение wDeviceType. Список типов устройств см. в разделе Типы устройств MCI.
Целочисленные возвращаемые значения — это значения DWORD , возвращаемые в буфере, на который указывает элемент lpstrReturn структуры, определяемой lpSysInfo.
Строковые возвращаемые значения — это строки, завершающиеся нулевыми значениями, возвращаемыми в буфере, на который указывает член lpstrReturn структуры, определяемой lpSysInfo.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|