comando MCI_OPEN
Il comando MCI_OPEN inizializza un dispositivo o un file. Tutti i dispositivi riconoscono questo comando.
Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_OPEN,
DWORD dwFlags,
(DWORD) (LPMCI_OPEN_PARMS) lpOpen
);
Parametri
-
wDeviceID
-
Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.
-
Dwflags
-
MCI_NOTIFY o MCI_WAIT. Per informazioni su questi flag, vedere Flag di attesa, notifica e test.
-
lpOpen
-
Puntatore a una struttura MCI_OPEN_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.
Valore restituito
Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.
Commenti
Il flag MCI_OPEN_TYPE deve essere usato ogni volta che un dispositivo viene specificato nella funzione mciSendCommand . Se si apre un dispositivo specificando una costante di tipo dispositivo, è necessario specificare il flag di MCI_OPEN_TYPE_ID oltre a MCI_OPEN_TYPE. Per un elenco delle costanti di tipo dispositivo, vedere Tipi di dispositivi MCI.
Se il flag di MCI_OPEN_SHAREABLE non viene specificato all'apertura iniziale di un dispositivo o di un file, tutti i comandi di MCI_OPEN successivi al dispositivo o al file avranno esito negativo. Se il dispositivo o il file è già aperto e questo flag non viene specificato, la chiamata avrà esito negativo anche se il primo comando aperto specificato MCI_OPEN_SHAREABLE. File aperti per MCISEQ. DRV e MCIWAVE. I dispositivi DRV non sono condivisibili.
Il case viene ignorato nel nome del dispositivo, ma non possono essere presenti spazi vuoti iniziali o finali.
Per usare la selezione automatica del tipo (tramite le voci del Registro di sistema), assegnare il nome file e l'estensione di file al membro lpstrElementName della struttura identificata da lpOpen, impostare il membro lpstrDeviceType su NULL e impostare il flag MCI_OPEN_ELEMENT.
I flag aggiuntivi seguenti si applicano a tutti i dispositivi che supportano MCI_OPEN:
-
MCI_OPEN_ALIAS
-
Un alias è incluso nel membro lpstrAlias della struttura identificata da lpOpen.
-
MCI_OPEN_SHAREABLE
-
Il dispositivo o il file deve essere aperto come condivisibile.
-
MCI_OPEN_TYPE
-
Un nome o una costante del tipo di dispositivo è incluso nel membro lpstrDeviceType della struttura identificata da lpOpen.
-
MCI_OPEN_TYPE_ID
-
La parola in ordine basso del membro lpstrDeviceType della struttura identificata da lpOpen contiene un identificatore di tipo di dispositivo MCI standard e la parola di ordine elevato contiene facoltativamente l'indice ordinale per il dispositivo. Usare questo flag con il flag MCI_OPEN_TYPE.
I flag aggiuntivi seguenti si applicano ai dispositivi composti:
-
MCI_OPEN_ELEMENT
-
Un nome file è incluso nel membro lpstrElementName della struttura identificata da lpOpen.
-
MCI_OPEN_ELEMENT_ID
-
Il membro lpstrElementName della struttura identificata da lpOpen viene interpretato come valore DWORD e ha un significato interno al dispositivo. Usare questo flag con il flag MCI_OPEN_ELEMENT.
I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo digitalvideo :
-
MCI_DGV_OPEN_NOSTATIC
-
Il dispositivo deve ridurre il numero di colori statici (di sistema) nella tavolozza. Questo aumenta il numero di colori disponibili per il rendering del flusso video. Questo flag si applica solo ai dispositivi che condividono una tavolozza con Windows.
-
MCI_DGV_OPEN_PARENT
-
L'handle della finestra padre viene specificato nel membro hWndParent della struttura identificata da lpOpen.
-
MCI_DGV_OPEN_WS
-
Uno stile di finestra viene specificato nel membro dwStyle della struttura identificata da lpOpen.
-
MCI_DGV_OPEN_16BIT
-
Indica una preferenza per il supporto dei dispositivi MCI a 16 bit.
-
MCI_DGV_OPEN_32BIT
-
Indica una preferenza per il supporto dei dispositivi MCI a 32 bit.
Per i dispositivi digital-video, il parametro lpOpen punta a una struttura MCI_DGV_OPEN_PARMS .
I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo di sovrimpressione :
-
MCI_OVLY_OPEN_PARENT
-
L'handle della finestra padre viene specificato nel membro hWndParent della struttura identificata da lpOpen.
-
MCI_OVLY_OPEN_WS
-
Uno stile di finestra viene specificato nel membro dwStyle della struttura identificata da lpOpen. Il valore dwStyle specifica lo stile della finestra che il driver creerà e visualizzerà se l'applicazione non ne fornisce uno. Il parametro style accetta un numero intero che definisce lo stile della finestra. Queste costanti sono le stesse degli stili di finestra standard, ad esempio WS_CHILD, WS_OVERLAPPEDWINDOW o WS_POPUP.
Per i dispositivi di sovrapposizione video, il parametro lpOpen punta a una struttura MCI_OVLY_OPEN_PARMS .
Il flag aggiuntivo seguente viene usato con il tipo di dispositivo waveaudio :
-
MCI_WAVE_OPEN_BUFFER
-
Una lunghezza del buffer viene specificata nel membro dwBufferSeconds della struttura identificata da lpOpen.
Per i dispositivi waveform-audio, il parametro lpOpen punta a una struttura MCI_WAVE_OPEN_PARMS . 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 |
|