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 |
|