Ler em inglês

Compartilhar via


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