Sysinfo

wsprintf(lpstrCommand, "sysinfo %s %s %s", lpszDeviceID, lpszRequest, lpszFlags);

Возвращаемое значение

В случае успешного завершения работы возвращает нулевое значение и значение ошибки в противном случае.

Аргументы

0. lpszDeviceID — идентификатор устройства MCI или тип устройства. Если указывается тип устройства, он должен представлять собой один из стандартных типов устройства, перечисленных в описании команды capability. Если флаг, установленный в аргументе lpszReques, допускает такую возможность, то в данном аргументе может быть передано значение all.

1. lpszRequest — может принимать одно из следующих значений:

• installname — возвращает имя, указанное в системном реестре или файле system.ini и использованное для открытия устройства, определяемого своим идентификатором.

• quantity — возвращает общее число устройств типа, указанного в аргументе lpszDeviceID, содержащихся в системном реестре или файле system.ini. Указанный идентификатор устройства должен представлять собой один из стандартных типов устройства. Любые числовые значения, расположенные после типа устройства игнорируются. Если в аргументе lpszDeviceID передаётся значение all, то возвращается общее количество устройств MCI, установленных в системе.

• quantity open — возвращает общее число открытых устройств типа, указанного в аргументе lpszDeviceID. Указанный идентификатор устройства должен представлять собой один из стандартных типов устройства. Если в аргументе lpszDeviceID передаётся значение all, то возвращается общее количество устройств MCI, открытых в системе.

• name index — возвращает имя устройства MCI. Указанный идентификатор устройства должен представлять собой один из стандартных типов устройства. Значение аргумента index изменяется от 1 до общего числа устройств данного типа. Если в аргументе lpszDeviceID передаётся значение all, то значение аргумента index изменяется от 1 до общего числа устройств MCI, установленных в системе.

• name index open — возвращает имя открытого устройства MCI. Указанный идентификатор устройства должен представлять собой один из стандартных типов устройства. Значение аргумента index изменяется от 1 до общего числа открытых устройств данного типа. Если в аргументе lpszDeviceID передаётся значение all, то значение аргумента index изменяется от 1 до общего числа открытых устройств MCI, установленных в системе.

0. lpszFlags — может принимать значения wait, notify или оба этих значения. Для устройств вывода видео информации и видеомагнитофонов может быть также установлен флаг test.

Примечание

Команда sysinfo позволяет получить системную информацию об устройствах MCI. Эта команда является системной командой MCI и интерпретируется непосредственно MCI, минуя драйверы устройств.

Приведённая ниже команда возвращает число открытых устройств вывода аудио информации в формате ИКМ.

sysinfo waveaudio quantity open

Приведённая ниже команда возвращает имя (альтернативное имя устройства) первого открытого устройства вывода аудио информации в формате ИКМ:

sysinfo waveaudio name 1 open