Команда list

Команда list определяет количество и типы входных видео- и аудиоданных. Устройства с цифровым видео и VCR распознают эту команду.

Чтобы отправить эту команду, вызовите функцию mciSendString с заданным параметром lpszCommand , как показано ниже.

_stprintf_s(
  lpszCommand, 
  TEXT("list %s %s %s"), 
  lpszDeviceID, 
  lpszList, 
  lpszFlags
); 

Параметры

lpszDeviceID

Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.

lpszList

Флаг, определяющий количество и типы входных видео- и аудиоданных. В следующей таблице перечислены типы устройств, которые распознают команду list , и флаги, используемые каждым типом.

Значение	Значение	Значение
digitalvideo	алгоритм аудиосистемы алгоритм качества алгоритмааудиопотокаcountnumber index	still algorithmtill алгоритм качества алгоритм видеоалгоритмавидео качества алгоритмавидеоисточниквидеопоток
Видео	audio source countaudio source number index	video source countvideo source number index

В следующей таблице перечислены флаги, которые можно указать в параметре lpszList , и их значения.

Значение	Значение
алгоритм звука	Указывает, что команда должна извлекать имена алгоритмов звука.
Алгоритм алгоритма качества звука	Указывает, что команда должна извлекать уровни качества, связанные с указанным алгоритмом. Если алгоритм имеет значение "current", возвращается уровень качества текущего алгоритма.
число источников звука	Возвращает общее количество входных звуковых данных.
Индекс исходного номера аудио	Возвращает тип входных звуковых данных исходного индекса.
аудиопоток	Указывает, что команда должна извлекать имена звуковых потоков, связанных с рабочей областью. Эти строки (например, "Английский" или "Немецкий") внедряются в файл и идентифицируют поток.
count	Возвращает количество параметров указанного типа.
числовой индекс	Возвращает строку, описывающую конкретный параметр (определяемый индексом) указанного типа параметра. Индекс должен быть целым числом от 1 до значения, возвращаемого параметром "count".
алгоритм по-прежнему	Указывает, что команда должна извлекать имена алгоритмов по-прежнему.
Алгоритм алгоритма по-прежнему качества	Указывает, что команда должна извлекать уровни качества, связанные с указанным алгоритмом неподвижности. Если алгоритм имеет значение "current", возвращается уровень качества текущего алгоритма.
алгоритм видео	Указывает, что команда должна извлекать имена алгоритмов видео.
Алгоритм алгоритма качества видео	Указывает, что команда должна получать уровни качества, связанные с указанным алгоритмом видео. Если алгоритм имеет значение "current", возвращается уровень качества текущего алгоритма.
источник видео	Указывает, что команда должна возвращать сведения об источниках видео. При использовании с флагом count возвращается количество источников видео. При использовании с флагом "число" он возвращает тип источника видео. MCI определяет следующие константы для типа: "ntsc", "rgb", "pal", "secam", "svideo" и "generic". Для каждого типа может быть несколько источников. "Универсальный" тип источника используется, если для этого соединителя разрешено несколько сигналов.
количество источников видео	Возвращает общее количество входных видеоданных.
индекс номера источника видео	Возвращает тип входного видео исходного индекса.
видеопоток	Указывает, что команда должна извлекать имена видеопотоков, связанных с рабочей областью. Эти строки (например, "смешное окончание" или "печальное окончание") внедряются в файл и идентифицируют поток.

lpszFlags

Может иметь значение "wait", "notify" или "test". Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

Комментарии

Для устройств VCR необходимо указать "источник видео" или "источник звука" с флагами "количество" или "число". Если указано значение count, возвращается общее количество входных данных видео или звука. Если указано "число", драйвер возвращает тип, соответствующий входным данным. Тип может быть любым из следующих типов: tuner, line, svideo, aux или generic. Как правило, сначала следует запросить у VCR значение "count", а затем использовать счетчик в качестве диапазона для флага "число". "Исходные" числа начинаются с 1.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]

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

MCI

Командные строки MCI