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

Vedi anche

MCI

Comandi MCI