comando MCI_STOP

  • Artigo

O comando MCI_STOP interrompe todas as sequências de reprodução e gravação, descarrega todos os buffers de reprodução e interrompe a exibição de imagens de vídeo. Os dispositivos de áudio de CD, vídeo digital, sequenciador MIDI, videodisc, VCR 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_STOP, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpStop
);

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.

lpStop

Ponteiro para uma estrutura MCI_GENERIC_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

A diferença entre os comandos MCI_STOP e MCI_PAUSE depende do dispositivo. Se possível, MCI_PAUSE suspende a operação do dispositivo, mas deixa o dispositivo pronto para retomar a reprodução imediatamente.

Para o dispositivo de áudio cd, MCI_STOP redefine a posição da faixa atual para zero; por outro lado, MCI_PAUSE mantém a posição atual da faixa, antecipando que o dispositivo voltará a ser reproduzido.

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