comando MCI_CUE

O comando MCI_CUE indica um dispositivo para que a reprodução ou gravação comece com o mínimo de atraso. Os dispositivos de vídeo digital, 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_CUE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpCue
);

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.

lpCue

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

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

MCI_DGV_CUE_INPUT

Uma instância de vídeo digital deve se preparar para gravação. Se o aplicativo não tiver espaço em disco reservado, o dispositivo reservará o espaço em disco usando seus parâmetros padrão. O aplicativo poderá omitir esse sinalizador se a origem da apresentação atual já for a entrada externa. (Esse sinalizador não tem efeito na seleção da origem da apresentação.)

MCI_DGV_CUE_NOSHOW

Uma instância de vídeo digital deve se preparar para reproduzir o quadro especificado com o comando sem exibi-lo. Quando esse sinalizador é especificado, a exibição continua a mostrar a imagem no buffer de quadros, mesmo que seu quadro correspondente não seja a posição atual. Por exemplo, se o buffer de quadro contiver a imagem do quadro 7, o dispositivo continuará a mostrar o quadro 7 quando esse sinalizador for usado para sinalizar o dispositivo para qualquer outra posição. Um comando de indicação subsequente sem esse sinalizador e sem o sinalizador MCI_TO exibe o quadro atual.

MCI_DGV_CUE_OUTPUT

Uma instância de vídeo digital deve se preparar para ser reproduzida. Se o workspace estiver em pausa, nenhum posicionamento ocorrerá. Se o workspace for interrompido, a posição poderá ser alterada para uma imagem de quadro-chave anterior. O aplicativo poderá omitir esse sinalizador se a origem da apresentação atual já for o workspace.

MCI_TO

Uma posição de workspace é incluída no membro dwTo da estrutura identificada por lpCue. As unidades atribuídas aos valores de posição são especificadas usando o sinalizador MCI_SET_TIME_FORMAT do comando MCI_SET . Isso é equivalente a buscar uma posição, exceto que o dispositivo é pausado após o comando .

Para dispositivos digitalvideo , o parâmetro lpCue aponta para uma estrutura MCI_DGV_CUE_PARMS .

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

MCI_FROM

O membro dwFrom da estrutura apontada por lpCue contém o local inicial especificado no formato de hora atual.

MCI_TO

O membro dwTo da estrutura apontada por lpCue contém o local final (pausando) especificado no formato de hora atual.

MCI_VCR_CUE_INPUT

Prepare-se para gravação.

MCI_VCR_CUE_OUTPUT

Prepare-se para jogar. Se nem MCI_VCR_CUE_INPUT nem MCI_VCR_CUE_OUTPUT forem especificados, MCI_VCR_CUE_OUTPUT será assumido.

MCI_VCR_CUE_PREROLL

Indica o dispositivo para a posição atual ou a posição dwFrom , menos a duração do pré-registro. Isso permitirá que o dispositivo se prepare antes de entrar no modo de gravação ou reprodução.

MCI_VCR_CUE_REVERSE

A direção do próximo comando de reprodução ou gravação é inversa.

Ao solicitar a reprodução usando o comando MCI_CUE com o sinalizador MCI_VCR_CUE_OUTPUT, você pode cancelar MCI_CUE emitindo o comando MCI_PLAY com MCI_FROM, MCI_TO ou MCI_VCR_PLAY_REVERSE.

Ao sinalizar para gravação usando MCI_CUE com o sinalizador MCI_VCR_CUE_INPUT, você pode cancelar MCI_CUE emitindo o comando MCI_RECORD com MCI_FROM, MCI_TO ou MCI_VCR_RECORD_INITIALIZE.

Para dispositivos vcr , o parâmetro lpCue aponta para uma estrutura MCI_VCR_CUE_PARMS .

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

MCI_WAVE_INPUT

Um dispositivo de entrada waveform-audio deve ser atualizado.

MCI_WAVE_OUTPUT

Um dispositivo de saída waveform-audio deve ser atualizado. Esse será o sinalizador padrão se um sinalizador não for especificado.

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