команда MCI_LIST

Статья
12/06/2023

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

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_LIST, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpList
);

Параметры

wDeviceID: Идентификатор устройства MCI, которое требуется получить командное сообщение.
dwFlags: MCI_NOTIFY, MCI_WAIT или MCI_TEST. Сведения об этих флагах см. в разделе "Ожидание", "Уведомление" и "Тестовые флаги".
lpList: Указатель на структуру MCI_GENERIC_PARMS . (Устройства с расширенными наборами команд могут заменить эту структуру структурой для конкретного устройства.)

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

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

Замечания

Следующие дополнительные флаги применяются к типу устройства Digitalvideo :

MCI_DGV_LIST_ALG

Элемент lpstrAlgorithm структуры, определяемой lpList , содержит адрес буфера, содержащего имя алгоритма. Имя используется для получения типов дескрипторов качества, связанных с алгоритмом.

MCI_DGV_LIST_COUNT

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

MCI_DGV_LIST_ITEM

Константа, указывающая тип списка, включена в элемент dwItem структуры, определяемой lpList. Этот флаг является обязательным. Используйте одну из следующих констант, чтобы указать тип списка:

MCI_DGV_LIST_AUDIO_ALG

Команда должна получить имена звуковых алгоритмов.

MCI_DGV_LIST_AUDIO_QUALITY

Команда должна получить уровни качества звука. Возвращаемые уровни связаны с алгоритмом , на который ссылается член lpstrAlgorithm структуры, определяемой lpList. Если этот элемент указан с помощью строки current, возвращаются качества, связанные с текущим алгоритмом.

MCI_DGV_LIST_AUDIO_STREAM

Команда должна получить имена аудиопотоков.

MCI_DGV_LIST_STILL_AL

Команда должна получить имена по-прежнему алгоритмов.

MCI_DGV_LIST_STILL_QUALITY

Команда должна получить уровни качества. Возвращаемые уровни связаны с алгоритмом , на который ссылается член lpstrAlgorithm структуры, определяемой lpList. Если этот элемент указан с помощью строки current, возвращаются качества, связанные с текущим алгоритмом.

MCI_DGV_LIST_VIDEO_ALG

Команда должна получить имена алгоритмов видео.

MCI_DGV_LIST_VIDEO_QUALITY

Команда должна получить уровни качества видео. Возвращаемые уровни связаны с алгоритмом , на который ссылается член lpstrAlgorithm структуры, определяемой lpList. Если этот элемент указан с помощью строки current, возвращаются качества, связанные с текущим алгоритмом.

MCI_DGV_LIST_VIDEO_SOURCE

Команда должна возвращать сведения о источниках видео. При использовании с MCI_DGV_LIST_COUNT команда возвращает количество источников видео. При использовании с MCI_DGV_LIST_NUМБ ER команда возвращает тип источника видео. MCI определяет следующие типы:

MCI_DGV_SETVIDEO_SRC_GENERIC
MCI_DGV_SETVIDEO_SRC_NTSC
MCI_DGV_SETVIDEO_SRC_PAL
MCI_DGV_SETVIDEO_SRC_RGB
MCI_DGV_SETVIDEO_SRC_SECAM
MCI_DGV_SETVIDEO_SRC_SVIDEO

Может быть несколько источников возвращаемого типа. Универсальный тип источника используется, если для этого соединителя разрешено несколько типов сигнала.

MCI_DGV_LIST_VIDEO_STREAM

Команда должна получить имена видеопотоков.

MCI_DGV_LIST_NUМБ ER

Индекс указывается в элементе dwNumber структуры, определяемой lpList. Индекс должен быть целым числом от 1 до значения, возвращаемого для флага MCI_DGV_LIST_COUNT.

Для устройств цифрового видео lpList указывает на структуру MCI_DGV_LIST_PARMS .

К типу устройства vcr применяются следующие дополнительные флаги:

MCI_VCR_LIST_AUDIO_SOURCE: Вывод списка входных или типов звука.
MCI_VCR_LIST_COUNT: Задает элемент dwReturn структуры, определяемой lpList, общим количеством входных данных видео или звука.
MCI_VCR_LIST_NUМБ ER: Задает элемент dwReturn структуры, определяемой lpList, типом входных данных видео или звука, заданных членом dwNumber.
MCI_VCR_LIST_VIDEO_SOURCE: Вывод списка входных данных или типов видео.

Для устройств VCR lpList указывает на структуру MCI_VCR_LIST_PARMS.

Requirements

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхний колонтитул	Mmsystem.h (включая Windows.h)

См. также

MCI
Команды MCI

Поделиться через