Comando MCI_LIST

El comando MCI_LIST obtiene información sobre el número y los tipos de entradas disponibles para el dispositivo. Los dispositivos de vídeo digital y VCR reconocen este comando.

Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.

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

Parámetros

wDeviceID

Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Para obtener información sobre estas marcas, consulte Marcas de espera, notificación y prueba.

lpList

Puntero a una estructura MCI_GENERIC_PARMS. (Los dispositivos con conjuntos de comandos extendidos pueden reemplazar esta estructura por una estructura específica del dispositivo).

Valor devuelto

Devuelve un valor de cero si se ejecuta correctamente o un error en caso contrario.

Comentarios

Las siguientes marcas adicionales se aplican al tipo de dispositivo digitalvideo:

MCI_DGV_LIST_ALG

El miembro lpstrAlgorithm de la estructura identificada por lpList contiene una dirección de un búfer que contiene el nombre de un algoritmo. El nombre se usa para recuperar los tipos de descriptores de calidad asociados a un algoritmo.

MCI_DGV_LIST_COUNT

Devuelve el número de opciones del tipo especificado.

MCI_DGV_LIST_ITEM

Constante que indica que el tipo de lista está incluido en el miembro dwItem de la estructura identificada por lpList. Se requiere esta marca. Use una de las siguientes constantes para indicar el tipo de lista:

MCI_DGV_LIST_AUDIO_ALG

El comando debe recuperar nombres de algoritmos de audio.

MCI_DGV_LIST_AUDIO_QUALITY

El comando debe recuperar los niveles de calidad de audio. Los niveles devueltos están asociados al algoritmo al que hace referencia el miembro lpstrAlgorithm de la estructura identificada por lpList. Si se especifica ese miembro mediante la cadena "current", se devuelven las cualidades asociadas al algoritmo actual.

MCI_DGV_LIST_AUDIO_STREAM

El comando debe recuperar los nombres de las secuencias de audio.

MCI_DGV_LIST_STILL_AL

El comando debe recuperar los nombres de los todavía algoritmos.

MCI_DGV_LIST_STILL_QUALITY

El comando debe recuperar los niveles de calidad. Los niveles devueltos están asociados al algoritmo al que hace referencia el miembro lpstrAlgorithm de la estructura identificada por lpList. Si se especifica ese miembro mediante la cadena "current", se devuelven las cualidades asociadas al algoritmo actual.

MCI_DGV_LIST_VIDEO_ALG

El comando debe recuperar nombres de algoritmos de vídeo.

MCI_DGV_LIST_VIDEO_QUALITY

El comando debe recuperar los niveles de calidad de vídeo. Los niveles devueltos están asociados al algoritmo al que hace referencia el miembro lpstrAlgorithm de la estructura identificada por lpList. Si se especifica ese miembro mediante la cadena "current", se devuelven las cualidades asociadas al algoritmo actual.

MCI_DGV_LIST_VIDEO_SOURCE

El comando debe devolver información sobre los orígenes de vídeo. Cuando se usa con MCI_DGV_LIST_COUNT, el comando devuelve el número de orígenes de vídeo. Cuando se usa con MCI_DGV_LIST_NUMBER, el comando devuelve el tipo de un origen de vídeo. MCI define lo siguiente:

• 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

Puede haber más de un origen de cada tipo devuelto. El tipo de origen genérico se usa cuando se permite más de un tipo de señal para ese conector.

MCI_DGV_LIST_VIDEO_STREAM

El comando debe recuperar los nombres de las secuencias de vídeo.

MCI_DGV_LIST_NUMBER

Se especifica un índice en el miembro dwNumber de la estructura identificada por lpList. El índice debe ser un entero entre 1 y el valor devuelto de la marca MCI_DGV_LIST_COUNT.

En el caso de los dispositivos de vídeo digital, lpList apunta a una estructura de MCI_DGV_LIST_PARMS.

Las siguientes marcas adicionales se aplican al tipo de dispositivo vcr:

MCI_VCR_LIST_AUDIO_SOURCE

Enumera entradas o tipos de audio.

MCI_VCR_LIST_COUNT

Establece el miembro dwReturn de la estructura identificada por lpList en el número total de entradas de vídeo o audio.

MCI_VCR_LIST_NUMBER

Establece el miembro dwReturn de la estructura identificada por lpList en el tipo de la entrada de vídeo o audio especificada por el miembro dwNumber.

MCI_VCR_LIST_VIDEO_SOURCE

Enumera entradas o tipos de vídeo.

En el caso de los dispositivos VCR, lpList apunta a una estructura MCI_VCR_LIST_PARMS.

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Mmsystem.h (incluye Windows.h)

Consulte también

MCI

Comandos de MCI