Comando list

O comando list determina o número e os tipos de entradas de vídeo e áudio. Os dispositivos de vídeo digital e VCR reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

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

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszList

Sinalizador que identifica o número e os tipos de entradas de vídeo e áudio. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando de lista e os sinalizadores usados por cada tipo.

Valor	Significado	Significado
digitalvideo	algoritmo de áudio algoritmo de qualidade do algoritmode qualidade streamcountnumber index	algoritmo stillmiscar algoritmode algoritmo de qualidade algoritmo de vídeovídeo algoritmo de qualidade algoritmofonte de vídeovídeo fluxo
Videocassete	fonte de áudio countaudio índice de número de origem	video source countvideo source number index

A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszList e seus significados.

Valor	Significado
algoritmo de áudio	Especifica que o comando deve recuperar nomes de algoritmo de áudio.
algoritmo de qualidade de áudio	Especifica que o comando deve recuperar níveis de qualidade associados ao algoritmo especificado. Se o algoritmo for "atual", o nível de qualidade do algoritmo atual será retornado.
contagem de fontes de áudio	Retorna o número total de entradas de áudio.
índice de número da fonte de áudio	Retorna o tipo de entrada de áudio do índice de origem.
fluxo de áudio	Especifica que o comando deve recuperar os nomes dos fluxos de áudio associados ao workspace. Essas cadeias de caracteres (como "inglês" ou "alemão") são inseridas no arquivo e identificam o fluxo.
count	Retorna o número de opções do tipo especificado.
índice numérico	Retorna uma cadeia de caracteres que descreve uma opção específica (conforme identificado pelo índice) do tipo de opção especificado. O índice deve ser um inteiro entre 1 e o valor retornado por "count".
algoritmo still	Especifica que o comando deve recuperar nomes de algoritmos ainda.
algoritmo de qualidade ainda	Especifica que o comando deve recuperar níveis de qualidade associados ao algoritmo still especificado. Se o algoritmo for "atual", o nível de qualidade do algoritmo atual será retornado.
algoritmo de vídeo	Especifica que o comando deve recuperar nomes de algoritmo de vídeo.
algoritmo de qualidade de vídeo	Especifica que o comando deve recuperar níveis de qualidade associados ao algoritmo de vídeo especificado. Se o algoritmo for "atual", o nível de qualidade do algoritmo atual será retornado.
fonte de vídeo	Especifica que o comando deve retornar informações sobre as fontes de vídeo. Quando usado com o sinalizador "count", ele retorna o número de fontes de vídeo. Quando usado com o sinalizador "number", ele retorna o tipo de uma fonte de vídeo. O MCI define as seguintes constantes para o tipo: "ntsc", "rgb", "pal", "secam", "svideo" e "generic". Pode haver mais de uma fonte de cada tipo retornado. O tipo de origem "genérico" é usado quando mais de um sinal é permitido para esse conector.
contagem de fontes de vídeo	Retorna o número total de entradas de vídeo.
índice de número de origem do vídeo	Retorna o tipo de entrada de vídeo do índice de origem.
fluxo de vídeo	Especifica que o comando deve recuperar os nomes dos fluxos de vídeo associados ao workspace. Essas cadeias de caracteres (como "final engraçado" ou "final triste") são inseridas no arquivo e identificam o fluxo.

lpszFlags

Pode ser "wait", "notify" ou "test". Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Para dispositivos VCR, "fonte de vídeo" ou "fonte de áudio" deve ser especificada com os sinalizadores "count" ou "number". Se "count" for especificado, o número total de entradas de vídeo ou áudio será retornado. Se "number" for especificado, o driver retornará um tipo correspondente à entrada. O tipo pode ser qualquer um dos seguintes: "tuner", "line", "svideo", "aux" ou "generic". Normalmente, você deve primeiro consultar o VCR para a "contagem" e, em seguida, usar a contagem como o intervalo para o sinalizador "number". Os números de "origem" começam a partir de 1.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

MCI

Cadeias de caracteres de comando MCI