Leggere in inglese

Condividi tramite


comando open

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