comando status

Observação

Comunicação sem preconceitos A Microsoft dá suporte a um ambiente diversificado e inclusão. Neste documento, há referências à palavra "escravo". O Guia de Estilo da Microsoft para comunicações de Bias-Free reconhece isso como uma palavra excludente. Essa redação é usada, pois atualmente é a redação usada dentro dos comandos. Para consistência, este documento contém essa palavra. Quando essa palavra for alterada nos comandos, corrigiremos este documento para estar em alinhamento.

O comando status solicita informações status de um dispositivo. Todos os dispositivos 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("status %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 para solicitar informações de status. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando status e os sinalizadores usados por cada tipo.

Tipo de dispositivo	Sinalizadores de solicitação
cdaudio	cdaudio type track number faixa atual comprimento número da faixa de comprimento mídia presente mode número de faixas position número da faixa de posição Pronto posição inicial formato de hora
digitalvideo	áudio alinhamento de áudio bitspersample de áudio quebras de áudio bytespersec de áudio entrada de áudio registro de áudio fonte de áudio exemplos de áudiopersec fluxo de áudio Baixo bitsperpel Brilho cor contraste faixa atual unidade de espaço em disco conclusão do arquivo formato de arquivo modo de arquivo avançar quadros ignorados gamma input volume esquerdo comprimento número da faixa de comprimento mídia presente mode monitor método monitor Nominal taxa de quadros nominal taxa de quadros de registro nominal número de faixas output identificador de paleta modo pause velocidade de jogo position número da faixa de posição Pronto taxa de quadros de registro quadro de referência tamanho reservado volume correto procurar exatamente Nitidez Smpte velocidade posição inicial formato de arquivo ainda formato de hora Tonalidade Agudos não salvo video índice de chave de vídeo cor da chave de vídeo registro de vídeo fonte de vídeo número da origem do vídeo fluxo de vídeo volume identificador de janela janela visível janela minimizada janela maximizada
overlay	mídia presente mode número de faixas Pronto Esticar identificador de janela
sequenciador	faixa atual tipo de divisão comprimento número da faixa de comprimento master mídia presente mode número de faixas deslocamento porta position número da faixa de posição Pronto Escravo posição inicial tempo formato de hora
Videocassete	registro assemble monitor de áudio número do monitor de áudio registro de áudio número da faixa de registro de áudio fonte de áudio número da fonte de áudio channel número do sintonizador de canal clock ID do relógio contador formato de contador resolução do contador faixa atual taxa de quadros índice index on comprimento número da faixa de comprimento mídia presente tipo de mídia mode número de faixas de áudio número de faixas número de faixas de vídeo pausar tempo limite formato de reprodução position início da posição número da faixa de posição duração do postroll ligar duração de pré-registro Pronto formato de registro velocidade formato de hora modo de tempo tipo de tempo timecode presente registro de código de tempo Tipo de código de hora número do sintonizador monitor de vídeo número do monitor de vídeo registro de vídeo número da faixa de registro de vídeo fonte de vídeo número da origem do vídeo gravação protegida
videodisc	faixa atual tamanho do disco avançar comprimento número da faixa de comprimento mídia presente tipo de mídia mode número de faixas position número da faixa de posição Pronto Lado velocidade posição inicial formato de hora
Waveaudio	alinhamento bitspersample bytespersec canais faixa atual marca de formato input comprimento número da faixa de comprimento nível mídia presente mode número de faixas output position número da faixa de posição Pronto samplespersec posição inicial formato de hora

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

Valor	Significado
alinhamento	Retorna o alinhamento de bloco de dados, em bytes.
registro assemble	Retornará TRUE se o dispositivo estiver definido para a gravação do modo assemble.
áudio	Retorna "ativado" ou "desativado" dependendo do comando setaudio "ativado" ou "desativado" mais recente. Ele retornará "ativado" se ambos os alto-falantes estiverem habilitados e "desativados" caso contrário.
alinhamento de áudio	Retorna o alinhamento dos blocos de dados em relação ao início dos dados de áudio de forma de onda de entrada.
bitspersample de áudio	Retorna o número de bits por exemplo que o dispositivo usa para gravação. Esse sinalizador se aplica somente a dispositivos que dão suporte ao algoritmo "pcm".
quebras de áudio	Retorna o número de vezes que a parte de áudio da última sequência AVI foi interrompida. O sistema conta uma quebra de áudio sempre que tenta gravar dados de áudio no driver do dispositivo e descobre que o driver já reproduziu todos os dados disponíveis. Esse sinalizador é reconhecido apenas pelo driver de vídeo digital MCIAVI. Destina-se apenas à avaliação de desempenho; o valor retornado é difícil de interpretar.
bytespersec de áudio	Retorna o número médio de bytes por segundo usados para gravação.
entrada de áudio	Retorna o nível de áudio instantâneo aproximado do sinal de áudio de entrada analógico. Um valor maior que 1000 implica distorção de recorte. Alguns dispositivos só podem retornar esse valor durante a gravação de áudio. O valor não tem nenhum comando set ou setaudio associado.
monitor de áudio	Retorna "output" ou um dos tipos de entrada de origem válidos. Para obter mais informações, consulte o comando setaudio "monitor".
número do monitor de áudio	Retorna o número de vídeo monitorado do tipo especificado por status "monitor de áudio". Para obter mais informações, consulte o comando setaudio .
registro de áudio	Retorna "ativado" ou "desativado", refletindo o estado definido por setaudio "record".
número da faixa de registro de áudio	Retornará TRUE se o VCR estiver definido para gravar áudio. Se nenhum número de faixa for fornecido, o valor padrão de 1 será assumido.
exemplos de áudiopersec	Retorna o número de exemplos por segundo registrado.
fonte de áudio	Retorna a fonte do digitalizador de áudio atual: "esquerda", "direita", "média" ou "estéreo".
número da fonte de áudio	Retorna o número de fonte de áudio do tipo retornado por status "fonte de áudio". Para obter mais informações, consulte o comando setaudio .
fluxo de áudio	Retorna o número de fluxo de áudio atual.
Baixo	Retorna o nível de baixo de áudio atual.
bitsperpel	Retorna o número de bits por pixel para salvar dados capturados ou gravados.
bitspersample	Retorna os bits por exemplo.
Brilho	Retorna o nível atual de brilho do vídeo.
bytespersec	Retorna o número médio de bytes por segundo reproduzido ou gravado.
cdaudio type track number	Retorna o tipo do número de faixa especificado. Isso pode ser "áudio" ou "outro".
channel	Retorna o valor inteiro do canal definido no sintonizador.
número do sintonizador de canal	Se o número "sintonizador" for dado, o canal selecionado no momento no número do sintonizador lógico será retornado. Observe que pode haver vários sintonizadores lógicos.
canais	Retorna o número de canais definidos (1 para mono, 2 para estéreo).
clock	Retorna a hora externa. O tempo deve ser um inteiro longo sem sinal que expresse incrementos totais. Para obter mais informações, consulte o comando "taxa de incremento do relógio" de funcionalidade .
ID do relógio	Retorna um inteiro exclusivo que identifica o relógio.
cor	Retorna o nível de cor atual.
contraste	Retorna o nível de contraste atual.
contador	Retorna a posição do contador, no formato de contador atual.
formato de contador	Retorna o formato do contador atual. Para obter mais informações, consulte o comando definir "formato de contador".
resolução do contador	Retorna "quadros" ou "segundos", indicando a resolução do contador. Isso não é o mesmo que precisão.
faixa atual	Retorna a faixa atual. O sequenciador MCISEQ retorna 1.
tamanho do disco	Retorna 8 ou 12, indicando o tamanho do disco carregado em polegadas.
unidade de espaço em disco	Retorna o espaço em disco aproximado, no formato de tempo atual, que pode ser obtido por um comando de reserva para a unidade de disco especificada. A unidade geralmente é especificada como uma única letra ou uma única letra seguida por dois-pontos (:). Alguns dispositivos, no entanto, podem usar um caminho.
tipo de divisão	Retorna um dos seguintes tipos de divisão de arquivos: PPQN Quadro SMPTE 24 Quadro SMPTE 25 Quadro suspenso SMPTE 30 Quadro SMPTE 30 Use essas informações para determinar o formato do arquivo MIDI e o significado das informações de tempo e posição.
conclusão do arquivo	Retorna o percentual estimado em que uma operação de carregamento, salvamento, captura, corte, cópia, exclusão, colagem ou desfazer progrediu. (Os aplicativos podem usar isso para fornecer um indicador visual de progresso.)
formato de arquivo	Retorna o formato de arquivo atual para gravar ou salvar comandos.
modo de arquivo	Retorna "carregando", "salvando", "editando" ou "ocioso". Durante uma operação de carga , ela retorna "carregamento". Durante as operações de salvamento e captura , ele retorna "salvando". Durante as operações recortar, copiar, excluir, colar ou desfazer , ela retorna "edição".
marca de formato	Retorna a marca de formato.
avançar	Retornará TRUE se a direção da reprodução for para frente ou se o dispositivo não estiver sendo reproduzido.
taxa de quadros	Retorna o número de quadros por segundo que o dispositivo usará por padrão. Os dispositivos NTSC retornam 30, PAL 25 e assim por diante.
quadros ignorados	Retorna o número de quadros que não foram desenhados quando a última sequência AVI foi reproduzida. Esse sinalizador é reconhecido apenas pelo driver de vídeo digital MCIAVI. Destina-se apenas à avaliação de desempenho; o valor retornado é difícil de interpretar.
gamma	Retorna o valor definido com o valor setvideo "gamma to ".
índice	Retorna a exibição de índice atual. Para obter mais informações, consulte o comando "index" definido .
index on	Retornará TRUE se o índice estiver ativado.
input	Retorna o conjunto de entrada. Se um não estiver definido, o erro retornado indicará que qualquer dispositivo pode ser usado. Para dispositivos de vídeo digital, modifica o sinalizador "graves", "agudos", "volume", "brilho", "cor", "contraste", "gama", "nitidez" ou "tonalidade" para que ele se aplique apenas à entrada. Esse é o padrão ao monitorar a entrada.
volume esquerdo	Retorna o conjunto de volumes para o canal de áudio esquerdo.
comprimento	Retorna o comprimento total da mídia, no formato de hora atual. Para arquivos PPQN, o comprimento é retornado em unidades de ponteiro de música. Para arquivos SMPTE, ele é retornado como hh:mm:ss:ff, onde hh é horas, mm é minutos, ss é segundos e ff é quadros. Para dispositivos VCR, o comprimento é de 2 horas (a menos que o comprimento tenha sido explicitamente alterado usando o comando set ).
número da faixa de comprimento	Retorna o comprimento da faixa, em tempo ou quadros, especificado por número. Para arquivos PPQN, o comprimento é retornado em unidades de ponteiro de música. Para arquivos SMPTE, ele é retornado como hh:mm:ss:ff, onde hh é horas, mm é minutos, ss é segundos e ff é quadros.
nível	Retorna o valor de exemplo de áudio PCM atual.
master	Retorna "midi", "none" ou "smpte" dependendo do tipo de conjunto de sincronização.
mídia presente	Retornará TRUE se a mídia for inserida no dispositivo ou FALSE caso contrário. Os dispositivos sequencer, video-overlay, digital-video e waveform-audio retornam TRUE.
tipo de mídia	Retorna o tipo da mídia. Para VCRS, isso é "8mm", "vhs", "svhs", "beta", "Hi8", "edbeta" ou "other". Para videodiscs, isso é "CAV", "CLV" ou "outro", dependendo do tipo de videodisc.
mode	Retorna o modo atual do dispositivo. Todos os dispositivos podem retornar os valores "não pronto", "pausado", "reproduzindo" e "parado". Alguns dispositivos podem retornar os valores adicionais "open", "parked", "recording" e "seeking".
monitor	Retorna "file" ou "input". O valor retornado indica a origem da apresentação atual.
método monitor	Retorna "pre", "post" ou "direct". O valor retornado indica o método usado para monitoramento de entrada.
Nominal	O item modifica os sinalizadores "bass", "brightness", "color", "contrast", "gamma", "sharpness", "tint", "treble" e "volume" para retornar o valor nominal em vez da configuração atual.
taxa de quadros nominal	Retorna a taxa de quadros nominal associada ao arquivo. As unidades estão em quadros por segundo multiplicados por 1000.
taxa de quadros de registro nominal	Retorna a taxa de quadros nominal associada ao sinal de vídeo de entrada. As unidades estão em quadros por segundo multiplicados por 1000.
número de faixas de áudio	Retorna o número de faixas de áudio na mídia.
número de faixas	Retorna o número de faixas na mídia. Os dispositivos MCISEQ e MCIWAVE retornam 1, assim como a maioria dos dispositivos VCR. O dispositivo MCIPIONR não dá suporte a esse sinalizador.
número de faixas de vídeo	Retorna o número de faixas de vídeo na mídia.
deslocamento	Retorna o deslocamento de um arquivo baseado em SMPTE. O deslocamento é a hora de início de uma sequência baseada em SMPTE. O tempo é retornado como hh:mm:ss:ff, onde hh é horas, mm é minutos, ss é segundos e ff é quadros.
output	Retorna a saída definida no momento. Se nenhuma saída for definida, o erro retornado indicará que qualquer dispositivo pode ser usado. Para dispositivos de vídeo digital, modifica o sinalizador "graves", "agudos", "volume", "brilho", "cor", "contraste", "gama", "nitidez" ou "tonalidade" para que se aplique apenas à saída. Esse é o padrão ao monitorar um arquivo.
modo pause	Retornará "gravação" se o dispositivo estiver em pausa durante a gravação. Ele retornará "reproduzindo" se o dispositivo estiver em pausa durante a reprodução. Ele retornará o erro "Ação não aplicável no modo atual" se o dispositivo não estiver em pausa.
pausar tempo limite	Retorna a duração máxima, em milissegundos, de um comando de pausa .
formato de reprodução	Retorna um código que indica o formato em que a fita de vídeo será reproduzida novamente, se detectável: "lp", "ep", "sp" ou "other". Para obter mais informações, consulte o sinalizador "formato de registro".
velocidade de jogo	Retorna um valor que representa o quão próximo o tempo real de reprodução da última sequência AVI correspondeu ao tempo de jogo de destino. O valor 1000 indica que o tempo de destino e o tempo real eram os mesmos. Um valor de 2000, por exemplo, indicaria que a sequência de AVI demorou duas vezes mais tempo para ser reproduzida do que deveria. Esse sinalizador é reconhecido apenas pelo driver de vídeo digital MCIAVI. Destina-se apenas à avaliação de desempenho; o valor retornado é difícil de interpretar.
porta	Retorna o número da porta MIDI atribuído à sequência.
position	Retorna a posição atual. Para arquivos PPQN, a posição é retornada em unidades de ponteiro de música. Para arquivos SMPTE, ele é retornado como hh:mm:ss:ff, onde hh é horas, mm é minutos, ss é segundos e ff é quadros.
início da posição	Retorna a posição do início da mídia utilizável.
número da faixa de posição	Retorna a posição do início da faixa especificada por número. Para arquivos PPQN, o formato de hora é retornado em unidades de ponteiro de música. Para arquivos SMPTE, ele é retornado como hh:mm:ss:ff, onde hh é horas, mm é minutos, ss é segundos e ff é quadros. O sequenciador MCISEQ retorna zero. O dispositivo MCIPIONR não dá suporte a esse sinalizador. O dispositivo MCIWAVE retorna zero.
duração do postroll	Retorna o comprimento da fita de vídeo, no formato de tempo atual, necessário para frear o transporte vcr quando um comando de parada ou pausa é emitido.
ligar	Retornará TRUE se a energia do VCR estiver ativada.
duração de pré-registro	Retorna o comprimento da fita de vídeo, no formato de tempo atual, necessário para estabilizar a saída do VCR.
Pronto	Retornará TRUE se o dispositivo estiver pronto para aceitar outro comando.
formato de registro	Retorna um código que indica o formato em que a fita de vídeo será gravada. Os tipos de retorno atuais são "lp", "ep", "sp" ou "other". Esses formatos não são específicos do VHS e podem ser aplicados a qualquer VCR que tenha vários formatos de gravação selecionáveis. O tipo "sp" é o formato de gravação mais rápido e de alta qualidade e é usado como padrão em VCRs de formato único.
taxa de quadros de registro	Retorna a taxa de quadros, em quadros por segundo multiplicados por 1000, usada para compactação.
quadro de referência	Retorna o número do quadro para a imagem de quadro chave mais próxima que precede o quadro especificado.
tamanho reservado	Retorna o tamanho, no formato de hora atual, do workspace reservado. O tamanho corresponde ao tempo aproximado necessário para reproduzir os dados compactados de um workspace completo. Ele retornará zero se não houver espaço em disco reservado. Esse sinalizador retorna o tamanho aproximado porque o espaço em disco preciso para dados compactados não pode, em geral, ser previsto até que os dados sejam compactados.
volume correto	Retorna o conjunto de volumes para o canal de áudio correto.
samplespersec	Retorna o número de exemplos por segundo reproduzidos ou gravados.
procurar exatamente	Retorna "ativado" ou "desativado", indicando se o sinalizador "buscar exatamente" está definido ou não.
Nitidez	Retorna o nível de nitidez atual do dispositivo.
Lado	Retorna 1 ou 2 para indicar qual lado do videodisc está carregado.
Escravo	Retorna "file" , "midi", "none" ou "smpte" dependendo do tipo de conjunto de sincronização.
Smpte	Retorna o código de tempo SMPTE associado à posição atual no workspace. Essa é uma cadeia de caracteres com o formulário dd:dd:dd:dd, em que cada d indica um dígito de 0 a 9. Se os dados do workspace não incluirem dados de código de tempo, esse sinalizador retornará 00:00:00:00.
velocidade	Retorna a velocidade atual do dispositivo em quadros por segundo (ou no mesmo formato usado pelo comando "speed" definido ). O player de videodisc MCIPIONR não dá suporte a esse sinalizador.
posição inicial	Retorna a posição inicial da mídia.
formato de arquivo ainda	Retorna o formato de arquivo atual para o comando de captura .
Esticar	Retornará TRUE se o alongamento estiver habilitado.
tempo	Retorna o tempo atual de uma sequência MIDI no formato de hora atual. Para arquivos com formato PPQN, o tempo está em batidas por minuto. Para arquivos com formato SMPTE, o tempo está em quadros por segundo.
formato de hora	Retorna o formato de hora atual. Para obter mais informações, consulte os formatos de tempo no comando set .
modo de tempo	Retorna o modo de tempo de posição atual. Pode ser "detectar", "timecode" ou "contador".
tipo de tempo	Retorna o tempo de posição atual em uso: "timecode" ou "counter".
timecode presente	Retornará TRUE se o código de tempo tiver sido gravado na posição atual na fita. O código de tempo deve avançar da posição atual. Um VCR pode precisar ser reproduzido para marcar essa condição.
registro de código de tempo	Retornará TRUE se o VCR estiver definido como o código de tempo de registro.
Tipo de código de hora	Retorna "smpte", "smpte drop", "other" ou "none". Observe que os quadros por segundo podem ser obtidos do comando "taxa de quadros" status e a precisão do dispositivo pode ser retornada pelo comando "buscar precisão" da funcionalidade.
Tonalidade	Retorna o nível de tonalidade de vídeo atual.
Agudos	Retorna o nível de áudio-agudo atual.
número do sintonizador	Retorna o número do sintonizador lógico atual.
não salvo	Retornará TRUE se houver dados registrados no workspace que podem ser perdidos como resultado de um comando close, load, record, reserve, cut, delete ou paste . Retorna FALSE caso contrário.
video	Retorna "ativado" ou "desativado", refletindo o estado definido pelo comando setvideo .
cor da chave de vídeo	Retorna o valor da cor da chave.
índice de chave de vídeo	Retorna o valor do índice de chave.
monitor de vídeo	Retorna "output" ou um dos tipos de entrada de origem válidos. Para obter mais informações, consulte o comando setvideo "monitor".
número do monitor de vídeo	Retorna o número de vídeo monitorado do tipo retornado por status "monitor de vídeo". Para obter mais informações, consulte o comando setvideo .
registro de vídeo	Retorna "ativado" ou "desativado", refletindo o estado atual definido por setvideo "record".
número da faixa de registro de vídeo	Retornará TRUE se o VCR estiver definido para gravar vídeo. Se nenhum número de faixa for fornecido, o valor padrão de 1 será assumido.
fonte de vídeo	Retorna o tipo de fonte de vídeo. Para obter mais informações, consulte o comando setvideo .
número da origem do vídeo	Retorna um número correspondente à fonte de vídeo do tipo em uso. Por exemplo, ele retornará 2 se a segunda entrada de origem de vídeo NTSC estiver sendo usada.
fluxo de vídeo	Retorna o número de fluxo de vídeo atual.
volume	Retorna o volume médio para o alto-falante esquerdo e direito. Isso retornará um erro se o dispositivo não tiver sido reproduzido ou se o volume não tiver sido definido.
identificador de janela	Retorna o valor decimal ASCII para o identificador de janela na palavra de baixa ordem do valor retornado.
janela maximizada	Retornará TRUE se a janela for maximizada.
janela minimizada	Retornará TRUE se a janela for minimizada.
janela visível	Retornará TRUE se a janela não estiver oculta.
gravação protegida	Retornará TRUE se o dispositivo detectar que não pode gravar (ou seja, se a proteção de gravação estiver ativada). Se ele puder gravar ou se não for possível determinar se ele pode ou não gravar (sem realmente gravar), o driver retornará FALSE.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital e VCR, o "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 de mciSendString. As informações dependem do tipo de solicitação.

Comentários

Antes de emitir comandos que usam valores de posição, você deve definir o formato de hora desejado usando o comando set .

Exemplos

O comando a seguir retorna o modo atual do dispositivo "mysound".

status mysound mode

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

capability

Capturar

close

Cortar

delete

carga

pause

Colar

record

reserve

salvar

set

Setaudio

setvideo

stop

desfazer