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
);
-
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.
Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.
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.
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|