comando cue

O comando de indicação se prepara para reprodução ou gravação. Os dispositivos de vídeo digital, VCR e waveform-audio 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("cue %s %s %s"), 
  lpszDeviceID, 
  lpszInOutTo, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszInOutTo

Sinalizador que prepara um dispositivo para reprodução ou gravação. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando de indicação e os sinalizadores usados por cada tipo.

Valor Indicação Indicação
digitalvideo
  • input
  • noshow
  • output
  • para posicionar
Videocassete
  • da posição
  • input
  • output
  • Preroll
  • reverse
  • para posicionar
Waveaudio input output

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

Valor Significado
da posição Indica por onde começar.
input Prepara-se para gravação. Para dispositivos de vídeo digital, esse sinalizador poderá ser omitido se a origem da apresentação atual já for a entrada externa.
noshow Prepara-se para reproduzir um quadro sem exibi-lo. Quando esse sinalizador é especificado, a exibição continua a mostrar a imagem no buffer de quadros, mesmo que seu quadro correspondente não seja a posição atual. Um comando de indicação subsequente sem esse sinalizador e sem o sinalizador "para" exibe o quadro atual.
output Prepara-se para jogar. Se nem "input" nem "output" for especificado, a configuração padrão será "output".
Preroll Move a distância de pré-registro do ponto. O ponto é a posição atual ou a posição especificada pelo sinalizador "from".
reverse Indica que a direção da reprodução está no sentido inverso (para trás).
para posicionar Move o workspace para a posição especificada. Para dispositivos VCR, esse sinalizador indica onde parar.

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

Embora não seja necessário, emitir o comando de indicação antes de reproduzir ou gravar em alguns dispositivos pode reduzir o atraso antes que o dispositivo inicie a ação.

Esse comando falhará se a reprodução ou gravação estiver em andamento ou se o dispositivo estiver em pausa.

Ao sinalizar para reprodução (usando a indicação "output"), emitir o comando play com o sinalizador "from", "to" ou "reverse" cancela o comando de indicação.

Ao sinalizar para gravação (usando a indicação "input"), emitir o comando de registro com o sinalizador "from", "to" ou "initialize" cancela o comando de indicação.

Exemplos

O comando a seguir prepara o dispositivo "mysound" para gravação.

cue mysound input

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

jogar

record