Comando set

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 set estabelece as configurações de controle para o dispositivo. Áudio de CD, vídeo digital, sequenciador MIDI, VCR, videodisc, sobreposição de vídeo e dispositivos de áudio de forma de onda 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("set %s %s %s"),
  lpszDeviceID,
  lpszSetting,
  lpszFlags
);
      

Parâmetros

lpszDeviceID

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

lpszSetting

Sinalizador para estabelecer configurações de controle. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando set e os sinalizadores usados por cada tipo.

Tipo de dispositivo	Sinalizadores de comando
cdaudio	áudio desativado áudio ativado áudio deixado de fora áudio à esquerda áudio desativado áudio à direita em porta fechada porta aberta milissegundos de formato de tempo time format msf formato de tempo tmsf
digitalvideo	áudio desativado áudio ativado áudio deixado de fora áudio à esquerda áudio desativado áudio à direita em porta fechada porta aberta formato de arquivo procurar exatamente em procurar exatamente fora fator de velocidade formato de formato de arquivo ainda quadros de formato de tempo milissegundos de formato de tempo vídeo desativado vídeo em
overlay	áudio desativado áudio ativado áudio deixado de fora áudio à esquerda áudio desativado áudio à direita em porta fechada porta aberta vídeo desativado vídeo em
sequenciador	áudio desativado áudio ativado áudio deixado de fora áudio à esquerda áudio desativado áudio à direita em porta fechada porta aberta master MIDI master nenhum master SMPTE tempo de deslocamento mapeador de porta porta nenhuma porta port_number arquivo slave slave MIDI slave none slave SMPTE tempo tempo_value milissegundos de formato de tempo formato de tempo fps SMPTE formato de tempo SMPTE 30 drop ponteiro de música de formato de tempo
Videocassete	registro de montagem em registro de montagem desativado áudio desativado áudio ativado áudio deixado de fora áudio à esquerda áudio desativado áudio à direita em hora do relógio formato de contador valor do contador porta fechada porta aberta contador de índice data do índice tempo de índice tempo de índice duração de codelength pausar tempo limite duração do postroll – duration ligar desligar duração do pré-registro formato de registro SP LP de formato de registro EP de formato de registro fator de velocidade quadros de formato de tempo formato de hora hms milissegundos de formato de tempo time format msf formato de tempo fps SMPTE formato de tempo SMPTE 30 drop formato de tempo tmsf contador de modo de tempo detecção do modo de tempo time mode timecode acompanhamento de mais controle de subtração redefinição de acompanhamento
videodisc	áudio desativado áudio ativado áudio deixado de fora áudio à esquerda áudio desativado áudio à direita em porta fechada porta aberta quadros de formato de tempo formato de hora hms milissegundos de formato de tempo faixa de formato de tempo vídeo desativado vídeo em
Waveaudio	inteiro de alinhamento qualquer entrada qualquer saída áudio desativado áudio ativado áudio deixado de fora áudio à esquerda áudio desativado áudio à direita em bitspersample bit_count bytespersec byte_rate canais channel_count porta fechada porta aberta formatar marca pcm marca de formato inteiro de entrada inteiro de saída inteiro samplespersec bytes de formato de tempo milissegundos de formato de tempo exemplos de formato de tempo

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

Valor	Significado
inteiro de alinhamento	Define o alinhamento dos blocos de dados em relação ao início dos dados passados para o dispositivo waveform-audio. O arquivo é salvo nesse formato.
qualquer entrada	Use qualquer entrada que dê suporte ao formato atual ao gravar. Essa é a configuração padrão.
qualquer saída	Use qualquer saída que dê suporte ao formato atual ao ser reproduzido. Esse é o padrão.
registro de montagem em registro de montagem desativado	No modo de montagem, todas as faixas são registradas conforme definido pelo dispositivo. A maioria dos VCRs está no modo de montagem por padrão.
áudio desativado áudio ativado	Desabilita ou habilita a saída de áudio. Dispositivos de sobreposição de vídeo, o sequenciador MCISEQ e o dispositivo de áudio de forma de onda MCIWAVE não dão suporte a esse sinalizador.
áudio deixado de fora áudio à esquerda áudio desativado áudio à direita em	Desabilita ou habilita a saída para o canal de áudio esquerdo ou direito. Dispositivos de sobreposição de vídeo, o sequenciador MCISEQ e o dispositivo de áudio de forma de onda MCIWAVE não dão suporte a esse sinalizador.
bitspersample bit_count	Define o número de bits por amostra pcm (Modulação de Código de Pulso) reproduzido ou gravado. O arquivo é salvo nesse formato.
bytespersec byte_rate	Define o número médio de bytes por segundo reproduzido ou gravado. O arquivo é salvo nesse formato.
canais channel_count	Define os canais para reprodução e gravação. O arquivo é salvo nesse formato.
hora do relógio	Define o tempo no relógio externo como hora. O formato é especificado como um inteiro longo sem sinal.
formato de contador	Defina o formato de hora para o contador, conforme retornado por status "contador". Para obter informações sobre os tipos aplicáveis, consulte o comando set "time format".
valor do contador	Define o contador vcr como o valor especificado. O valor deve ser especificado no formato de contador atual. Para obter mais informações, consulte o comando set "counter format".
porta fechada	Retira a bandeja e fecha a porta, se possível. Para VCRs, carrega a fita automaticamente.
porta aberta	Abre a porta e ejeta a bandeja ou fita, se possível.
formato de arquivo	Especifica um formato de arquivo usado para comandos de salvamento ou captura . Se omitido, isso pode usar como padrão um formato definido pelo driver de dispositivo. Se o formato de arquivo especificado entrar em conflito com o algoritmo e a qualidade selecionados no momento, eles serão alterados para os padrões para o formato de arquivo. Os seguintes formatos de arquivo são definidos: avi: especifica o formato AVI. avss: especifica o formato AVSS. dib: especifica o formato DIB. jfif: especifica o formato JFIF. jpeg: especifica o formato JPEG. mpeg: especifica o formato MPEG. rdib: especifica o formato RLE DIB. rjpeg: especifica o formato RJPEG.
formatar marca pcm	Define o tipo de formato como PCM para reprodução e gravação. O arquivo é salvo nesse formato.
marca de formato	Define o tipo de formato para reprodução e gravação. O arquivo é salvo nesse formato.
index timecode contador de índice data do índice tempo de índice	Define a tela de exibição atual no VCR.
inteiro de entrada	Define o canal de áudio usado como entrada.
duração do comprimento	Define o comprimento especificado pelo usuário da fita no VCR. Esse comprimento é retornado pelo comando "length" status e é fornecido para compatibilidade com aplicativos que exigem que esse comando retorne um comprimento válido.
master midi	Define o sequenciador MIDI como a origem da sincronização. Os dados de sincronização são enviados no formato MIDI. O sequenciador MCISEQ não dá suporte a esse sinalizador.
master nenhum	Impede que o sequenciador MIDI envie dados de sincronização. O sequenciador MCISEQ não dá suporte a esse sinalizador.
master smpte	Define o sequenciador MIDI como a origem da sincronização. Os dados de sincronização são enviados no formato SMPTE (Society of Motion Picture and Television Engineers). O sequenciador MCISEQ não dá suporte a esse sinalizador.
tempo de deslocamento	Define o tempo de deslocamento de SMPTE. O deslocamento é a hora de início de uma sequência baseada em SMPTE. O tempo é expresso como hh: mm: ss: ff, onde hh é horas, mm é minutos, ss é segundos e ff é quadros.
inteiro de saída	Define o canal de áudio usado como saída.
pausar tempo limite	Define a duração máxima, em milissegundos, de um comando de pausa . Um valor de tempo limite igual a zero indica que nenhum tempo limite ocorrerá.
duração do postroll	Define o comprimento, no formato de hora atual, necessário para frear o transporte de VCR quando um comando de parada ou pausa é emitido.
mapeador de porta	Define o mapeador MIDI como a porta que recebe as mensagens MIDI. Esse comando falhará se o mapeador MIDI ou uma porta de que ele precisa estiver sendo usado por outro aplicativo.
porta nenhum	Desabilita o envio de mensagens MIDI. Esse comando também fecha uma porta MIDI.
port_number de porta	Define a porta MIDI que recebe as mensagens MIDI. Esse comando falhará se a porta que você está tentando abrir estiver sendo usada por outro aplicativo.
ligar desligar	Define a energia do dispositivo como ativada ou desativada.
duração do pré-registro	Define o comprimento, no formato de hora atual, necessário para estabilizar a saída do VCR.
formato de registro SP LP de formato de registro EP de formato de registro	Define o modo de gravação do VCR como SP para reprodução padrão, EP para reprodução estendida ou LP para reprodução longa. Esses valores não se destinam a serem específicos do VHS. Eles são mapeados para os três modos apropriados com outros formatos de fita. Por exemplo, o SP mapeia para a gravação mais rápida e de alta qualidade.
inteiro samplespersec	Define a taxa de amostragem para reprodução e gravação. O arquivo é salvo nesse formato.
buscar exatamente em buscar exatamente fora	Seleciona um dos dois modos de busca. Com "buscar exatamente ativado", seek sempre passará para o quadro especificado. Com "buscar exatamente desativado", seek passará para o quadro-chave mais próximo antes do quadro especificado.
arquivo subordinado	Define o sequenciador MIDI para usar dados de arquivo como a origem da sincronização. Essa é a configuração padrão.
slave midi	Define o sequenciador MIDI para usar dados MIDI de entrada para a fonte de sincronização. O sequenciador reconhece dados de sincronização com o formato MIDI. O sequenciador MCISEQ não dá suporte a esse sinalizador.
slave none	Define o sequenciador MIDI para ignorar a sincronização
slave smpte	Define o sequenciador MIDI para usar dados MIDI de entrada para a fonte de sincronização. O sequenciador reconhece dados de sincronização com o formato SMPTE. O sequenciador MCISEQ não dá suporte a esse sinalizador.
fator de velocidade	Define a velocidade relativa da reprodução de vídeo e áudio do workspace. Fator é a taxa entre a taxa de quadros nominal e a taxa de quadros desejada, em que a taxa de quadros nominal é designada como 1000. (Uma taxa de 500 é meia velocidade normal, 2000 é duas vezes a velocidade normal e assim por diante.) Definir a velocidade como zero reproduz o vídeo o mais rápido possível sem soltar quadros e sem áudio.
formato de formato de arquivo ainda	Especifica o formato de arquivo usado para comandos de captura.
tempo tempo_value	Define o ritmo da sequência de acordo com o formato de hora atual. Para um arquivo baseado em PPQN, o tempo_value é interpretado como batidas por minuto. Para um arquivo baseado em SMPTE, o tempo_value é interpretado como quadros por segundo.
bytes de formato de tempo	Em um formato de arquivo PCM, define o formato de tempo como bytes. Todas as informações de posição são especificadas como bytes seguindo este comando.
quadros de formato de tempo	Define o formato de tempo como quadros. Todos os comandos que usam valores de posição assumirão quadros. Quando o dispositivo é aberto, os quadros são o modo padrão. Compatível com videodiscs usando o formato CAV.
formato de hora hms	Define o formato de tempo como horas, minutos e segundos. Todos os comandos que usam valores de posição assumirão o HMS. HMS é o formato padrão para videodiscs CLV. Especifique um valor HMS como hh:mm:ss, em que hh é horas, mm é minutos e ss é segundos. Você pode omitir um campo se ele e todos os campos a seguir forem zero. Por exemplo, 3, 3:0 e 3:0:0 são maneiras válidas de expressar 3 horas.
milissegundos de formato de tempo	Define o formato de tempo como milissegundos. Todos os comandos que usam valores de posição assumirão milissegundos. Você pode abreviar milissegundos como "ms". Para dispositivos sequenciais, o arquivo de sequência define o formato padrão como PPQN ou SMPTE. Os dispositivos de sobreposição de vídeo não dão suporte a esse sinalizador.
time format msf	Define o formato de tempo como minutos, segundos e quadros. Todos os comandos que usam valores de posição assumirão MSF (o formato padrão para áudio cd). Especifique um valor MSF como mm:ss:ff, em que mm é minutos, ss é segundos e ff é quadros. Você pode omitir um campo se ele e todos os campos a seguir forem zero. Por exemplo, 3, 3:0 e 3:0:0 são maneiras válidas de expressar 3 minutos. Os campos MSF têm os seguintes valores máximos: Minutos 99 Segundos 59 Quadros 74
exemplos de formato de tempo	Define o formato de tempo como exemplos. Todas as informações de posição são especificadas como exemplos seguindo este comando.
formato de tempo smpte 24 formato de tempo smpte 25 formato de tempo smpte 30	Define o formato de tempo como uma taxa de quadros SMPTE. Para VCRs, define o formato de hora como hh:mm:ss:ff, em que os valores legais são 00:00:00:00 a 23:59:59:xx e xx é um menor que os quadros por segundo, conforme especificado pelo número 24, 25 ou 30, conforme especificado no sinalizador. Na entrada, dois-pontos (:) são necessários para separar os componentes. As unidades menos significativas poderão ser omitidas se forem 00; por exemplo, 02:00 é o mesmo que 02:00:00:00. Todos os comandos que usam valores de posição assumirão o formato SMPTE. O arquivo de sequência define o formato padrão como PPQN ou SMPTE.
time format smpte 30 drop	Define o formato de tempo como taxa de quadros de soltar SMPTE 30. Para VCRs, o mesmo que SMPTE 30, exceto que determinadas posições de código de tempo são removidas do formato para ter as posições de código de tempo registradas para cada quadro (na taxa de quadros NTSC de 29,97 fps) correspondem a tempo real (a 30 fps). As posições de código de tempo descartadas são as seguintes: duas a cada minuto, no minuto, para os primeiros nove de cada dez minutos de conteúdo gravado. Por exemplo, às 01:04:59:29, a próxima posição do código de hora seria 01:05:00:02, não 01:05:00:00. Todos os comandos que usam valores de posição assumirão o formato SMPTE. O arquivo de sequência define o formato padrão como PPQN ou SMPTE.
ponteiro de música de formato de tempo	Define o formato de tempo como ponteiro de música (décimo sexto anotação). Todos os comandos que usam valores de posição assumirão unidades de ponteiro de música. Esse sinalizador é válido apenas para uma sequência do tipo de divisão PPQN.
formato de tempo tmsf	Define o formato de tempo como faixas, minutos, segundos e quadros. Todos os comandos que usam valores de posição assumirão TMSF. Especifique um valor TMSF como tt:mm:ss:ff, onde tt é faixas, mm é minutos, ss é segundos e ff é quadros. Você pode omitir um campo se ele e todos os campos a seguir forem zero. Por exemplo, 3, 3:0, 3:0:0 e 3:0:0:0 são todas maneiras válidas de expressar a faixa 3. Os campos TMSF têm os seguintes valores máximos: Faixas 99 Minutos 90 Segundos 59 Quadros 74
faixa de formato de tempo	Define o formato de posição como faixas. Todos os comandos que usam valores de posição assumirão faixas.
contador de modo de tempo	Define o modo de informações de posição para usar os contadores vcr.
detecção do modo de tempo	Define o modo de informações de posição com base na detecção de informações de código de tempo na fita. Se as informações de código de tempo forem detectadas, o tipo de hora será definido como "timecode"; caso contrário, o tipo de hora é definido como "contador". "Detectar" é um modo especial. Sempre que o driver é aberto, uma nova fita é inserida ou o comando "modo de hora" é emitido, o driver verifica o modo de hora atual disponível na fita e define "tipo de tempo" como "timecode" ou "counter". Depois que o "tipo de hora" for definido, o driver não o alterará até que uma das condições acima ocorra novamente.
time mode timecode	Define o modo de informações de posição para usar informações de "timecode" na fita.
acompanhamento de mais acompanhamento de menos controle de redefinição	Ajusta a velocidade do transporte de fita de vídeo em incrementos finos. Use os sinalizadores de "acompanhamento" quando uma imagem barulhenta for obtida de um VCR. "Acompanhamento de mais" aumenta a velocidade do transporte. "Acompanhamento de menos" diminui a velocidade do transporte. "Controle de redefinição" retorna o ajuste de acompanhamento para zero.
vídeo desativado	Desabilita a saída do vídeo.
vídeo em	Habilita a saída de vídeo.

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.

Comentários

Várias propriedades de dados waveform-audio são definidas quando o arquivo para armazenar os dados é criado. Essas propriedades descrevem como os dados são estruturados dentro do arquivo e não podem ser alterados quando a gravação é iniciada. A lista a seguir identifica estas propriedades:

• alinhamento
• bitspersample
• bytespersec
• canais
• marca format
• samplespersec

Exemplos

O comando a seguir define o formato de hora como milissegundos e define o formato waveform-audio como 8 bits, mono, 11 kHz.

set mysound time format ms bitspersample 8 channels 1 samplespersec 11025

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

Capturar

pause

salvar

stop