comando seek

O comando seek passa para a posição especificada e para. Os dispositivos de áudio de CD, vídeo digital, sequenciador MIDI, VCR, videodisc 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("seek %s %s %s"), 
  lpszDeviceID, 
  lpszSeekFlags, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszSeekFlags

Sinalizador para mover para uma posição especificada. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando seek e os sinalizadores usados por cada tipo.

Valor	Significado	Significado
cdaudio	para terminar em posição	para começar
digitalvideo	para terminar em posição	para começar
sequenciador	para terminar em posição	para começar
Videocassete	na marca de tempomark_numinverter	para terminar a posiçãoa ser iniciado
videodisc	inverter até o fim	para posicionarpara iniciar
Waveaudio	para terminar em posição	para começar

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

Valor	Significado
no momento	Indica quando o dispositivo deve começar a executar esse comando ou, se o dispositivo tiver sido cued, quando o comando cued for iniciado. Para obter mais informações, consulte o comando cue .
mark mark_num	Busca a marca relativa indicada por mark_num, que deve ser um valor inteiro positivo. As marcas são sinais gravados na fita VCR usando o comando mark e são usados para pesquisa em alta velocidade.
reverse	Indica que a direção de busca nos videodiscs VCRs e CAV é anterior. Esse sinalizador será inválido se o sinalizador "to" for especificado. Para VCRs, esse sinalizador deve ser usado com o sinalizador "mark".
para terminar	Busca até o final do conteúdo.
para posicionar	Especifica a posição para interromper a busca. Para dispositivos cdaudio , MCI retornará um erro fora do intervalo se a posição especificada for maior que o comprimento do disco.
para começar	Busca o início do conteúdo.

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 zero se tiver êxito ou um erro de outra forma.

Comentários

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

Os dispositivos de vídeo digital dão suporte a dois modos de busca, que podem ser alterados usando o comando set . O modo "buscar exatamente ativado" faz com que o comando seek se mova para o quadro especificado. O modo "buscar exatamente desativado" faz com que o comando seek se mova para o quadro de chave mais próximo antes do quadro especificado.

Se um dispositivo de áudio CD estiver sendo reproduzido quando o comando seek for emitido, a reprodução será interrompida. Quando o comando seek é emitido com um dispositivo videodisc, o dispositivo pesquisa usando avanço rápido ou reverso rápido com vídeo e áudio desativados.

Quando o comando seek é emitido com um dispositivo waveform-audio, o comportamento depende do tamanho da amostra. Se o tamanho da amostra for de 16 bits ou maior, procure mover-se para o início da amostra mais próxima quando uma posição especificada não coincidir com o início de uma amostra.

Exemplos

O comando a seguir busca o início do arquivo de mídia associado ao dispositivo "mysound".

seek mysound to start

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

marca

set