Compartilhar via


comando MCI_SEEK

O comando MCI_SEEK altera a posição atual no conteúdo o mais rápido possível. A saída de áudio e vídeo é desabilitada durante a busca. Depois que a busca for concluída, o dispositivo será interrompido. 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 mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SEEK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SEEK_PARMS) lpSeek
);

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT ou, para dispositivos de vídeo digital e VCR, MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpSeek

Ponteiro para uma estrutura MCI_SEEK_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Se um tamanho de exemplo de dados para um dispositivo for maior que 1 byte (como com dados estéreo de áudio de forma de onda), esse comando passará para o início do exemplo mais próximo quando uma posição especificada não coincidir com o início de um exemplo.

Os seguintes sinalizadores adicionais se aplicam a todos os dispositivos que dão suporte a MCI_SEEK:

MCI_SEEK_TO_END

Procure até o final do conteúdo.

MCI_SEEK_TO_START

Busque até o início do conteúdo.

MCI_TO

Uma posição é incluída no membro dwTo da estrutura identificada por lpSeek. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT do comando MCI_SET . Não use esse sinalizador com MCI_SEEK_TO_END ou MCI_SEEK_TO_START.

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo vcr :

MCI_VCR_SEEK_AT

O membro dwAt da estrutura identificada por lpSeek contém uma hora em que todo o comando começa.

MCI_VCR_SEEK_MARK

O membro dwMark da estrutura identificada por lpSeek contém a marca numerada a ser pesquisada.

MCI_VCR_SEEK_REVERSE

A direção de busca é inversa; isso é usado apenas com o sinalizador MCI_VCR_SEEK_MARK.

Para dispositivos VCR, o parâmetro lpSeek aponta para uma estrutura MCI_VCR_SEEK_PARMS .

O seguinte sinalizador adicional é usado com o tipo de dispositivo videodisc :

MCI_VD_SEEK_REVERSE

A direção da busca é inversa.

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]
Cabeçalho
Mmsystem.h (incluir Windows.h)

Confira também

MCI

Comandos MCI