Compartilhar via


comando capability

O comando de funcionalidade solicita informações sobre uma funcionalidade específica 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("capability %s %s %s"), 
  lpszDeviceID, 
  lpszRequest, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszRequest

Sinalizador que identifica uma funcionalidade de dispositivo. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando de funcionalidade e os sinalizadores usados por cada tipo:

Valor Tipo Tipo
cdaudio
  • pode ejetar
  • pode jogar
  • pode gravar
  • pode salvar
  • dispositivo composto
  • tipo de dispositivo
  • tem áudio
  • tem vídeo
  • usa arquivos
digitalvideo
  • pode ejetar
  • pode congelar
  • pode bloquear
  • pode jogar
  • pode gravar
  • pode reverter
  • pode salvar
  • pode esticar
  • pode esticar a entrada
  • pode testar
  • dispositivo composto
  • tipo de dispositivo
  • tem áudio
  • ainda tem
  • tem vídeo
  • taxa de reprodução máxima
  • taxa de jogo mínima
  • usa arquivos
  • usa paletas
  • windows
overlay
  • pode ejetar
  • pode congelar
  • pode jogar
  • pode gravar
  • pode salvar
  • pode esticar
  • dispositivo composto
  • tipo de dispositivo
  • tem áudio
  • tem vídeo
  • usa arquivos
  • windows
sequenciador
  • pode ejetar
  • pode jogar
  • pode gravar
  • pode salvar
  • dispositivo composto
  • tipo de dispositivo
  • tem áudio
  • tem vídeo
  • usa arquivos
Videocassete
  • pode detectar comprimento
  • pode ejetar
  • pode congelar
  • pode monitorar fontes
  • pode jogar
  • pode pré-registrar
  • pode visualizar
  • pode gravar
  • pode reverter
  • pode salvar
  • pode testar
  • taxa de incremento do relógio
  • dispositivo composto
  • tipo de dispositivo
  • tem áudio
  • tem relógio
  • tem o código de tempo
  • tem vídeo
  • número de marcas
  • buscar precisão
  • usa arquivos
videodisc
  • pode ejetar
  • pode jogar
  • pode gravar
  • pode reverter
  • pode salvar
  • CAV
  • CLV
  • dispositivo composto
  • tipo de dispositivo
  • taxa de jogo rápido
  • tem áudio
  • tem vídeo
  • taxa de reprodução normal
  • taxa de jogo lenta
  • usa arquivos
Waveaudio
  • pode ejetar
  • pode jogar
  • pode gravar
  • pode salvar
  • dispositivo composto
  • tipo de dispositivo
  • tem áudio
  • tem vídeo
  • entradas
  • outputs
  • usa arquivos

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

Flags Significado
pode detectar comprimento Retornará TRUE se o dispositivo puder detectar o comprimento da mídia.
pode ejetar Retornará TRUE se o dispositivo puder ejetar a mídia.
pode congelar Retornará TRUE se o dispositivo puder congelar dados no buffer de quadros.
pode bloquear Retornará TRUE se o dispositivo puder bloquear dados.
pode monitorar fontes Retornará TRUE se o dispositivo puder passar uma entrada (origem) para a saída monitorada, independentemente da seleção de entrada atual.
pode jogar Retornará TRUE se o dispositivo puder ser reproduzido.
pode pré-registrar Retornará TRUE se o dispositivo der suporte ao sinalizador "pré-registro" com o comando de indicação .
pode visualizar Retornará TRUE se o dispositivo der suporte a visualizações.
pode gravar Retornará TRUE se o dispositivo der suporte à gravação.
pode reverter Retornará TRUE se o dispositivo puder ser reproduzido inverso.
pode salvar Retornará TRUE se o dispositivo puder salvar dados.
pode esticar Retornará TRUE se o dispositivo puder esticar quadros para preencher um determinado retângulo de exibição.
pode esticar a entrada Retornará TRUE se o dispositivo puder redimensionar uma imagem no processo de digitalização no buffer de quadros.
pode testar Retornará TRUE se o dispositivo reconhecer o palavra-chave de teste.
Cav Quando combinado com outros itens, esse sinalizador especifica que as informações de retorno se aplicam aos videodiscs de formato CAV. Esse é o padrão se nenhum videodisc for inserido.
taxa de incremento do relógio Retorna o número de subdivisões que o relógio externo dá suporte por segundo. Se o relógio externo for um relógio de milissegundos, o valor retornado será 1000. Se o valor retornado for 0, nenhum relógio terá suporte.
clv Quando combinado com outros itens, esse sinalizador especifica que as informações de retorno se aplicam aos videodiscs de formato CLV.
dispositivo composto Retornará TRUE se o dispositivo der suporte a um nome de elemento (nome do arquivo).
tipo de dispositivo Retorna um nome de tipo de dispositivo, que pode ser um dos seguintes:
  • cdaudio
  • dat
  • digitalvideo
  • other
  • overlay
  • verificador
  • sequenciador
  • Videocassete
  • videodisc
  • Waveaudio
taxa de jogo rápido Retorna a taxa de reprodução rápida em quadros por segundo ou zero se o dispositivo não puder ser reproduzido rapidamente.
tem áudio Retornará TRUE se o dispositivo der suporte à reprodução de áudio.
tem relógio Retornará TRUE se o dispositivo tiver um relógio.
ainda tem Retornará TRUE se o dispositivo tratar arquivos com uma única imagem com mais eficiência do que arquivos de vídeo de movimento.
tem o código de tempo Retornará TRUE se o dispositivo for capaz de dar suporte ao código de tempo ou se for desconhecido.
tem vídeo Retornará TRUE se o dispositivo der suporte a vídeo.
entradas Retorna o número total de dispositivos de entrada.
taxa de reprodução máxima Retorna a taxa de reprodução máxima, em quadros por segundo, para o dispositivo.
taxa de jogo mínima Retorna a taxa de reprodução mínima, em quadros por segundo, para o dispositivo.
taxa de reprodução normal Retorna a taxa de reprodução normal, em quadros por segundo, para o dispositivo.
número de marcas Retorna o número máximo de marcas que podem ser usadas; zero indica que as marcas não têm suporte.
outputs Retorna o número total de dispositivos de saída.
buscar precisão Retorna a precisão esperada de uma pesquisa em quadros; 0 indica que o dispositivo é preciso no quadro, 1 indica que o dispositivo espera estar dentro de um quadro da posição de busca indicada e assim por diante.
taxa de reprodução lenta Retorna a taxa de reprodução lenta em quadros por segundo ou zero se o dispositivo não puder ser reproduzido lentamente.
usa arquivos Retornará TRUE se o armazenamento de dados usado por um dispositivo composto for um arquivo.
usa paletas Retornará TRUE se o dispositivo usar paletas.
windows Retorna o número de janelas de exibição simultâneas às quais o dispositivo pode dar suporte.

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

Retorna informações no parâmetro lpszReturnString da função mciSendString . As informações dependem do tipo de solicitação.

Exemplos

O comando a seguir retorna o tipo de dispositivo do dispositivo "mysound".

capability mysound device type

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

Cue