Leggere in inglese

Condividi tramite


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