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 |
|