Comando list

El comando list determina el número y los tipos de entradas de vídeo y audio. Los dispositivos de vídeo digital y VCR reconocen este comando.

Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.

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

Parámetros

lpszDeviceID

Identificador de un dispositivo MCI. Este identificador o alias se asigna cuando se abre el dispositivo.

lpszList

Marca que identifica el número y los tipos de entradas de vídeo y audio. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando list y las marcas usadas por cada tipo.

Valor	Significado	Significado
digitalvideo	algoritmo de audioaudio quality algorithm audiostreamcountnumber index	still algorithmstill quality algorithm algorithmvideo algorithmvideo quality algorithmvideo sourcevideo stream
Vcr	número de origen de audio countaudio source number index	recuento de orígenes de vídeoDes indexación de número de origen de vídeo

En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszList y sus significados.

Valor	Significado
algoritmo de audio	Especifica que el comando debe recuperar nombres de algoritmo de audio.
algoritmo de calidad de audio	Especifica que el comando debe recuperar los niveles de calidad asociados al algoritmo especificado. Si el algoritmo es "actual", se devuelve el nivel de calidad del algoritmo actual.
recuento de orígenes de audio	Devuelve el número total de entradas de audio.
índice de número de origen de audio	Devuelve el tipo de entrada de audio del índice de origen.
secuencia de audio	Especifica que el comando debe recuperar los nombres de las secuencias de audio asociadas al área de trabajo. Estas cadenas (como "inglés" o "alemán") se insertan en el archivo e identifican la secuencia.
count	Devuelve el número de opciones del tipo especificado.
índice de número	Devuelve una cadena que describe una opción específica (identificada por el índice) del tipo de opción especificado. El índice debe ser un entero entre 1 y el valor devuelto por "count".
algoritmo still	Especifica que el comando debe recuperar nombres de algoritmos todavía.
algoritmo de calidad	Especifica que el comando debe recuperar los niveles de calidad asociados al algoritmo still especificado. Si el algoritmo es "actual", se devuelve el nivel de calidad del algoritmo actual.
algoritmo de vídeo	Especifica que el comando debe recuperar nombres de algoritmo de vídeo.
algoritmo de algoritmo de calidad de vídeo	Especifica que el comando debe recuperar los niveles de calidad asociados al algoritmo de vídeo especificado. Si el algoritmo es "actual", se devuelve el nivel de calidad del algoritmo actual.
origen de vídeo	Especifica que el comando debe devolver información sobre los orígenes de vídeo. Cuando se usa con la marca "count", devuelve el número de orígenes de vídeo. Cuando se usa con la marca "number", devuelve el tipo de un origen de vídeo. MCI define las siguientes constantes para el tipo: "ntsc", "rgb", "pal", "secam", "svideo" y "generic". 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 una señal para ese conector.
recuento de orígenes de vídeo	Devuelve el número total de entradas de vídeo.
índice de número de origen de vídeo	Devuelve el tipo de entrada de vídeo del índice de origen.
secuencia de vídeo	Especifica que el comando debe recuperar los nombres de las secuencias de vídeo asociadas al área de trabajo. Estas cadenas (como "final divertido" o "final triste") se insertan en el archivo e identifican la secuencia.

lpszFlags

Puede ser "wait", "notify" o "test". Para obtener más información sobre estas marcas, vea Las marcas Wait, Notify y Test.

Valor devuelto

Devuelve cero si es correcto o si se produce un error de lo contrario.

Comentarios

En el caso de los dispositivos VCR, se debe especificar "origen de vídeo" o "origen de audio" con las marcas "count" o "number". Si se especifica "count", se devuelve el número total de entradas de vídeo o audio. Si se especifica "number", el controlador devuelve un tipo correspondiente a la entrada. El tipo puede ser cualquiera de los siguientes: "tuner", "line", "svideo", "aux" o "generic". Normalmente, primero debe consultar el VCR para el "count" y, a continuación, usar el recuento como intervalo para la marca "number". Los números de "origen" comienzan desde 1.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]

Consulte también

MCI

Cadenas de comandos de MCI