comando play

Il comando play avvia la riproduzione di un dispositivo. I dispositivi audio CD, digital-video, MIDI Sequencer, videodisc, VCR e waveform-audio riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
); 

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato all'apertura del dispositivo.

lpszPlayFlags

Contrassegno per la riproduzione di un dispositivo. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando play e i flag usati da ogni tipo.

Valore	Significato	Significato
cdaudio	dalla posizione	per posizionare
digitalvideo	dalla posizionea schermo intero ripetere	inverso alla finestra di posizione
sequencer	dalla posizione	per posizionare
Vcr	all'oradalla posizioneinversa	scansione in posizione
videodisc	veloce dall'analisi inversa della posizione	numero interoa velocità lenta da posizionare
Waveaudio	dalla posizione	per posizionare

Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszPlayFlags e i relativi significati.

Valore	Significato
alla volta	Indica quando il dispositivo deve iniziare a eseguire questo comando o, se il dispositivo è stato rilevato, all'avvio del comando cued. Per altre informazioni, vedere il comando cue .
veloce	Indica che il dispositivo deve essere riprodotto più velocemente del normale. Per determinare la velocità esatta in un lettore videodisc, usare il flag "speed" del comando di stato . Per specificare più precisamente la velocità, usare il flag "speed" di questo comando.
dalla posizione	Specifica una posizione iniziale per la riproduzione. Se il flag "from" non è specificato, la riproduzione inizia nella posizione corrente. Per i dispositivi cdaudio , se la posizione "da" è maggiore della posizione finale del disco o se la posizione "da" è maggiore della posizione "a", il driver restituisce un errore. Per i dispositivi di individuazione video , le posizioni predefinite sono in fotogrammi per dischi CAV e in ore, minuti e secondi per i dischi CLV.
Fullscreen	Specifica che deve essere utilizzata una visualizzazione a schermo intero. Usare questo flag solo durante la riproduzione di file compressi. I file non compressi non verranno riprodotti a schermo intero.
ripetere	Specifica che la riproduzione deve essere riavviata al raggiungimento della fine del contenuto.
reverse	Specifica che la direzione di riproduzione è all'indietro. Non è possibile specificare una posizione finale con il flag "inverso". Per i videodiscs, la "scansione" si applica solo al formato CAV.
Scansione	Riproduce il più velocemente possibile senza disabilitare il video (anche se l'audio potrebbe essere disabilitato). Per i videodiscs, la "scansione" si applica solo al formato CAV.
lento	Gioca lentamente. Per determinare la velocità esatta in un lettore videodisc, usare il flag "speed" del comando di stato . Per specificare più precisamente la velocità, usare il flag "speed" di questo comando. Per i videodiscs, "slow" si applica solo al formato CAV.
numero intero di velocità	Riproduce un videodisc alla velocità specificata, in fotogrammi al secondo. Questo flag si applica solo ai dischi CAV.
per posizionare	Specifica una posizione finale per la riproduzione. Se il flag "to" non è specificato, la riproduzione si arresta alla fine del contenuto. Per i dispositivi cdaudio , se la posizione "a" è maggiore della posizione finale del disco, il driver restituisce un errore. Per i dispositivi di individuazione video , le posizioni predefinite sono in fotogrammi per dischi CAV e in ore, minuti e secondi per i dischi CLV.
Finestra	Specifica che la riproduzione deve usare la finestra associata all'istanza del dispositivo. Si tratta dell'impostazione predefinita.

lpszFlags

Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video e VCR, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Flag di attesa, notifica e test.

Valore restituito

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

Commenti

Prima di eseguire comandi che usano valori di posizione, è necessario impostare il formato dell'ora desiderato usando il comando set . Questo comando inizia a giocare alla velocità corrente, come impostato con il comando "speed" impostato. La direzione è inversa se viene specificato il flag "inverso" o se il flag "to" viene specificato come valore minore del flag "from". Se il flag "from" non è specificato, la riproduzione inizia nella posizione corrente. I flag "to" e "reverse" non possono essere usati insieme.

Esempio

Il comando seguente riproduce il dispositivo "mysound" dalla posizione 1000 alla posizione 2000, inviando un messaggio di notifica al termine della riproduzione.

play mysound from 1000 to 2000 notify

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI

segnale

set