comando MCI_CUE

Il comando MCI_CUE indica un dispositivo in modo che la riproduzione o la registrazione inizi con un ritardo minimo. I dispositivi digital-video, VCR e waveform-audio riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CUE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpCue
);

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o, per i dispositivi digital-video e VCR, MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.

lpCue

Puntatore a una struttura MCI_GENERIC_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo digitalvideo :

MCI_DGV_CUE_INPUT

Un'istanza di video digitale deve prepararsi per la registrazione. Se l'applicazione non ha spazio su disco riservato, il dispositivo riserva lo spazio su disco usando i parametri predefiniti. L'applicazione può omettere questo flag se l'origine della presentazione corrente è già l'input esterno. Questo flag non ha alcun effetto sulla selezione dell'origine della presentazione.

MCI_DGV_CUE_NOSHOW

Un'istanza digitale-video deve prepararsi per la riproduzione del frame specificato con il comando senza visualizzarlo. Quando viene specificato questo flag, la visualizzazione continua a visualizzare l'immagine nel buffer dei fotogrammi anche se il frame corrispondente non è la posizione corrente. Ad esempio, se il buffer del frame contiene l'immagine dal frame 7, il dispositivo continua a visualizzare frame 7 quando questo flag viene usato per segnalare il dispositivo a qualsiasi altra posizione. Un comando di cue successivo senza questo flag e senza il flag MCI_TO visualizza il frame corrente.

MCI_DGV_CUE_OUTPUT

Un'istanza di video digitale deve prepararsi per la riproduzione. Se l'area di lavoro viene sospesa, non si verifica alcuna posizione. Se l'area di lavoro viene arrestata, la posizione potrebbe cambiare in un'immagine del fotogramma chiave precedente. L'applicazione può omettere questo flag se l'origine della presentazione corrente è già l'area di lavoro.

MCI_TO

Una posizione dell'area di lavoro è inclusa nel membro dwTo della struttura identificata da lpCue. Le unità assegnate ai valori di posizione vengono specificate usando il flag MCI_SET_TIME_FORMAT del comando MCI_SET . Questo equivale a cercare una posizione, ad eccezione del dispositivo viene sospeso dopo il comando.

Per i dispositivi digitalvideo , il parametro lpCue punta a una struttura MCI_DGV_CUE_PARMS .

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo vcr :

MCI_FROM

Il membro dwFrom della struttura puntato da lpCue contiene la posizione iniziale specificata nel formato ora corrente.

MCI_TO

Il membro dwTo della struttura puntato da lpCue contiene la posizione finale (sospensione) specificata nel formato ora corrente.

MCI_VCR_CUE_INPUT

Prepararsi per la registrazione.

MCI_VCR_CUE_OUTPUT

Prepararsi per giocare. Se non viene specificato né MCI_VCR_CUE_INPUT né MCI_VCR_CUE_OUTPUT, viene assunto MCI_VCR_CUE_OUTPUT.

MCI_VCR_CUE_PREROLL

Cue il dispositivo alla posizione corrente o alla posizione dwFrom , meno la durata della registrazione preliminare. Ciò consentirà al dispositivo di prepararsi prima di entrare in modalità record o riproduzione.

MCI_VCR_CUE_REVERSE

La direzione del comando play o record successivo è inversa.

Quando si esegue la riproduzione usando il comando MCI_CUE con il flag di MCI_VCR_CUE_OUTPUT, è possibile annullare MCI_CUE eseguendo il comando MCI_PLAY con MCI_FROM, MCI_TO o MCI_VCR_PLAY_REVERSE.

Quando si esegue la registrazione usando MCI_CUE con il flag di MCI_VCR_CUE_INPUT, è possibile annullare MCI_CUE eseguendo il comando MCI_RECORD con MCI_FROM, MCI_TO o MCI_VCR_RECORD_INITIALIZE.

Per i dispositivi vcr , il parametro lpCue punta a una struttura MCI_VCR_CUE_PARMS .

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo waveaudio :

MCI_WAVE_INPUT

Un dispositivo di input waveform-audio deve essere cuoiato.

MCI_WAVE_OUTPUT

Un dispositivo di output waveform-audio deve essere cuede. Questo è il flag predefinito se non è specificato un flag.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI