comando open

Articolo
06/12/2023

Il comando open inizializza un dispositivo. Tutti i dispositivi MCI 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("open %s %s %s"), 
  lpszDevice, 
  lpszOpenFlags, 
  lpszFlags
);

Parametri

lpszDevice

Identificatore di un dispositivo MCI o di un driver di dispositivo. Può trattarsi di un nome di dispositivo (come indicato nel Registro di sistema o nel file di SYSTEM.INI) o del nome file del driver di dispositivo. Se si specifica il nome del file del driver di dispositivo, è possibile includere facoltativamente . Estensione DRV, ma non è consigliabile includere il percorso del file.

lpszOpenFlags

Flag che identifica gli elementi da inizializzare. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando aperto e i flag usati da ogni tipo.

Valore	Significato	Significato
cdaudio	alias device_aliascondivisibile	tipo device_type
digitalvideo	alias device_aliaselementnamenostatic parent hwndsharable	stile stile figlio stile sovrapposto stile popup stile style_typetipo device_type
overlay	alias device_aliasfiglio dellostile condivisibile padre	stile di stile sovrapposto stile popup stile style_typetipo device_type
sequencer	alias device_alias condivisibile	tipo device_type
Vcr	alias device_aliascondivisibile	tipo device_type
videodisk	alias device_aliascondivisibile	tipo device_type
Waveaudio	device_aliasbuffer_size buffer alias	tipo condivisibile device_type

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

Valore	Significato
alias device_alias	Specifica un nome alternativo per il dispositivo specificato. Se specificato, deve essere usato come device_id nei comandi successivi.
Elementname	Specifica il nome dell'elemento del dispositivo (file) caricato all'apertura del dispositivo.
buffer buffer_size	Imposta le dimensioni, in secondi, del buffer utilizzato dal dispositivo audio waveform. Le dimensioni predefinite del buffer vengono impostate quando il dispositivo waveform-audio è installato o configurato. In genere, le dimensioni del buffer sono impostate su 4 secondi. Con il dispositivo MCIWAVE, la dimensione minima è di 2 secondi e la dimensione massima è di 9 secondi.
parent hwnd	Specifica l'handle di finestra della finestra padre.
Condivisibile	Inizializza il dispositivo o il file come condivisibile. I tentativi successivi di aprire il dispositivo o il file hanno esito negativo, a meno che non si specifichi "condivisibile" nei comandi aperti originali e successivi. MCI restituisce un errore di dispositivo non valido se il dispositivo è già aperto e non condivisibile. I dispositivi MCISEQ Sequencer e MCIWAVE non supportano i file condivisi.
stile figlio	Apre una finestra con uno stile di finestra figlio.
stile sovrapposto	Apre una finestra con uno stile di finestra sovrapposto.
popup di stile	Apre una finestra con uno stile finestra popup.
stile style_type	Indica uno stile di finestra.
tipo device_type	Specifica il tipo di dispositivo di un file.

lpszFlags

Può essere "wait", "notify" o entrambi. 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

MCI riserva "cdaudio" per il tipo di dispositivo audio CD, "videodisc" per il tipo di dispositivo videodisc, "sequencer" per il tipo di dispositivo MIDI Sequencer, "AVIVideo" per il tipo di dispositivo digital-video e "waveaudio" per il tipo di dispositivo waveform-audio.

In alternativa al flag "type", MCI può selezionare il dispositivo in base all'estensione usata dal file, come registrato nel Registro di sistema o nella sezione [mci extension] del file SYSTEM.INI.

MCI può aprire i file AVI usando un puntatore a interfaccia file o un puntatore a interfaccia di flusso. Per aprire un file usando un tipo di puntatore all'interfaccia, specificare un simbolo di chiocciolo (@) seguito dal puntatore di interfaccia al posto del nome del file o del dispositivo per il parametro lpszDevice . Per altre informazioni sulle interfacce di file e flusso, vedere " Funzioni e macro AVIFile".

Il comando seguente apre il dispositivo "mysound".

open new type waveaudio alias mysound buffer 6

Con il nome del dispositivo "new", il driver waveform prepara una nuova risorsa waveform. Il comando assegna l'alias del dispositivo "mysound" e specifica un buffer di 6 secondi.

È possibile eliminare il flag "type" se si combina il nome del dispositivo con il nome del file. MCI riconosce questa combinazione quando si usa la sintassi seguente:

device_name ! Element_name

Il punto esclamativo separa il nome del dispositivo dal nome del file. Il punto esclamativo non deve essere delimitato da spazi vuoti.

Nell'esempio seguente viene aperto RIGHT. File WAV con il dispositivo "waveaudio".

open waveaudio!right.wav

Il driver MCIWAVE richiede un dispositivo audio waveform asincrono.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Corecrt_io.h

Vedi anche

MCI
Stringhe di comando MCI

Condividi tramite