Compartilhar via


Comando info

O comando info recupera uma descrição de hardware de um dispositivo. Todos os dispositivos MCI 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("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszInfoType

Sinalizador que identifica o tipo de informação necessária. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando de informações e os sinalizadores usados por cada tipo.

Valor Significado Significado
cdaudio info identityinfo upc product
digitalvideo algoritmo de áudioservitório qualidadefileproductstill algoritmo ainda qualidade usageversionvideo algorithmvideo qualitywindow text
overlay fileproduct texto da janela
sequenciador copyrightfile nameproduct
Videocassete product version
videodisk product
Waveaudio fileinput outputproduct

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

Valor Significado
algoritmo de áudio Retorna o nome do algoritmo de compactação de áudio atual.
qualidade de áudio Retorna o nome do descritor de qualidade de áudio atual. Isso poderá retornar "desconhecido" se o aplicativo tiver definido parâmetros para valores específicos que não correspondem às qualidades definidas.
direitos autorais Recupera o aviso de direitos autorais do arquivo MIDI do meta evento de direitos autorais.
file Recupera o nome do arquivo usado pelo dispositivo composto. Se o dispositivo for aberto sem um arquivo e o comando load não tiver sido usado, uma cadeia de caracteres nula será retornada.
identidade de informações Produz um identificador exclusivo para o CD de áudio atualmente carregado no player que está sendo consultado.
info upc Produz o UPC (Código universal do produto) codificado em um CD de áudio. O UPC é uma cadeia de caracteres de dígitos. Ele pode não estar disponível para todos os CDs.
input Recupera a descrição do dispositivo de entrada atual. Retornará "none" se um dispositivo de entrada não estiver definido.
name Recupera o nome da sequência do meta evento sequence/track name.
output Recupera a descrição do dispositivo de saída atual. Retornará "none" se um dispositivo de saída não estiver definido.
product Recupera uma descrição do dispositivo. Essas informações geralmente incluem o nome e o modelo do produto. O comprimento da cadeia de caracteres será de 31 caracteres ou menos.
algoritmo still Retorna o nome do algoritmo de compactação de imagem ainda atual.
ainda qualidade Retorna o nome do descritor de qualidade de imagem ainda atual. Isso poderá retornar "desconhecido" se o aplicativo tiver definido parâmetros para valores específicos que não correspondem às qualidades definidas.
uso Retorna uma cadeia de caracteres que descreve restrições de uso que podem ser impostas pelo proprietário dos dados visuais ou de áudio no workspace.
version Retorna o nível de versão do driver e do hardware do dispositivo.
algoritmo de vídeo Retorna o nome do algoritmo de compactação de vídeo atual.
qualidade do vídeo Retorna o nome do descritor de qualidade de vídeo atual. Isso poderá retornar "desconhecido" se o aplicativo tiver definido parâmetros para valores específicos que não correspondem às qualidades definidas.
texto da janela Recupera o legenda da janela usada pelo dispositivo.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital e VCR, "teste" também pode ser especificado. 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.

Exemplos

O comando a seguir recupera uma descrição do hardware associado ao dispositivo "mysound".

info mysound product

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

carga