Compartilhar via


comando MCI_PLAY

O comando MCI_PLAY sinaliza o dispositivo para começar a transmitir dados de saída. 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_PLAY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_PLAY_PARMS ) lpPlay
);

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.

lpPlay

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

Valor Retornado

Retorna zero se tiver êxito ou um erro de outra forma.

Comentários

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

MCI_FROM

Um local inicial é incluído no membro dwFrom da estrutura identificada pelo lpPlay. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT do comando MCI_SET . Se MCI_FROM não for especificado, o local inicial usará como padrão a posição atual.

MCI_TO

Um local final é incluído no membro dwTo da estrutura identificada pelo lpPlay. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT de MCI_SET. Se MCI_TO não for especificado, o local final usará como padrão o final da mídia.

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

MCI_DGV_PLAY_REPEAT

A reprodução deve começar novamente no início, quando o final do conteúdo for atingido.

MCI_DGV_PLAY_REVERSE

A reprodução deve ocorrer ao contrário.

MCI_MCIAVI_PLAY_WINDOW

A reprodução deve ocorrer na janela associada a uma instância do dispositivo (o padrão). (Esse sinalizador é específico do MCIAVI. DRV.)

MCI_MCIAVI_PLAY_FULLSCREEN

A reprodução deve usar uma tela inteira. Use esse sinalizador somente ao reproduzir arquivos compactados ou de 8 bits.

Para dispositivos de vídeo digital, o lpPlay aponta para uma estrutura MCI_DGV_PLAY_PARMS .

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

MCI_VCR_PLAY_AT

O membro dwAt da estrutura identificada pelo lpPlay contém uma hora em que todo o comando começa ou se o dispositivo é fornecido, quando o dispositivo atinge a posição de from fornecida pelo comando MCI_CUE .

MCI_VCR_PLAY_REVERSE

A reprodução deve ocorrer ao contrário.

MCI_VCR_PLAY_SCAN

A reprodução deve ser o mais rápida possível enquanto mantém a saída de vídeo.

Para dispositivos VCR, lpPlay aponta para uma estrutura MCI_VCR_PLAY_PARMS .

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

MCI_VD_PLAY_FAST

Jogue rápido.

MCI_VD_PLAY_REVERSE

Reproduza ao contrário.

MCI_VD_PLAY_SCAN

Verifique rapidamente.

MCI_VD_PLAY_SLOW

Jogue devagar.

MCI_VD_PLAY_SPEED

A velocidade de reprodução é incluída no membro dwSpeed na estrutura identificada pelo lpPlay.

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 (inclua Windows.h)

Confira também

MCI

Comandos MCI