comando MCI_CUE

Articolo
06/13/2023

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

Condividi tramite