команда 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 [только классические приложения]
Заголовок
Mmsystem.h (включая Windows.h)

См. также раздел

MCI

Команды MCI