comando MCI_LIST

Il comando MCI_LIST ottiene informazioni sul numero e sui tipi di input disponibili per il dispositivo. I dispositivi digital-video e VCR riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_LIST, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpList
);

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Per informazioni su questi flag, vedere I flag wait, notify e test.

lpList

Puntatore a una struttura MCI_GENERIC_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.

Osservazioni:

I flag aggiuntivi seguenti si applicano al tipo di dispositivo digitalvideo :

MCI_DGV_LIST_ALG

Il membro lpstrAlgorithm della struttura identificata da lpList contiene un indirizzo di un buffer contenente il nome di un algoritmo. Il nome viene usato per recuperare i tipi di descrittori di qualità associati a un algoritmo.

MCI_DGV_LIST_COUNT

Restituisce il numero di opzioni del tipo specificato.

MCI_DGV_LIST_ITEM

Costante che indica che il tipo di elenco è incluso nel membro dwItem della struttura identificata da lpList. Questo flag è obbligatorio. Utilizzare una delle costanti seguenti per indicare il tipo di elenco:

MCI_DGV_LIST_AUDIO_ALG

Il comando deve recuperare i nomi degli algoritmi audio.

MCI_DGV_LIST_AUDIO_QUALITY

Il comando deve recuperare i livelli di qualità audio. I livelli restituiti sono associati all'algoritmo a cui fa riferimento il membro lpstrAlgorithm della struttura identificata da lpList. Se tale membro viene specificato utilizzando la stringa "current", vengono restituite le qualità associate all'algoritmo corrente.

MCI_DGV_LIST_AUDIO_STREAM

Il comando deve recuperare i nomi dei flussi audio.

MCI_DGV_LIST_STILL_AL

Il comando deve recuperare i nomi degli algoritmi ancora.

MCI_DGV_LIST_STILL_QUALITY

Il comando deve recuperare i livelli di qualità. I livelli restituiti sono associati all'algoritmo a cui fa riferimento il membro lpstrAlgorithm della struttura identificata da lpList. Se tale membro viene specificato utilizzando la stringa "current", vengono restituite le qualità associate all'algoritmo corrente.

MCI_DGV_LIST_VIDEO_ALG

Il comando deve recuperare i nomi degli algoritmi video.

MCI_DGV_LIST_VIDEO_QUALITY

Il comando deve recuperare i livelli di qualità video. I livelli restituiti sono associati all'algoritmo a cui fa riferimento il membro lpstrAlgorithm della struttura identificata da lpList. Se tale membro viene specificato utilizzando la stringa "current", vengono restituite le qualità associate all'algoritmo corrente.

MCI_DGV_LIST_VIDEO_SOURCE

Il comando deve restituire informazioni sulle origini video. Se usato con MCI_DGV_LIST_COUNT, il comando restituisce il numero di origini video. Se usato con MCI_DGV_LIST_NUMBER, il comando restituisce il tipo di origine video. MCI definisce i tipi seguenti:

• MCI_DGV_edizione StandardTVIDEO_SRC_GENERIC
• MCI_DGV_edizione StandardTVIDEO_SRC_NTSC
• MCI_DGV_edizione StandardTVIDEO_SRC_PAL
• MCI_DGV_edizione StandardTVIDEO_SRC_RGB
• MCI_DGV_edizione StandardTVIDEO_SRC_edizione Standard CAM
• MCI_DGV_edizione StandardTVIDEO_SRC_SVIDEO

Potrebbe essere presente più di un'origine di ogni tipo restituito. Il tipo di origine generico viene usato quando per tale connettore sono consentiti più tipi di segnale.

MCI_DGV_LIST_VIDEO_STREAM

Il comando deve recuperare i nomi dei flussi video.

MCI_DGV_LIST_NUMBER

Un indice viene specificato nel membro dwNumber della struttura identificata da lpList. L'indice deve essere un numero intero compreso tra 1 e il valore restituito per il flag MCI_DGV_LIST_COUNT.

Per i dispositivi digital-video, lpList punta a una struttura MCI_DGV_LIST_PARMS.

I flag aggiuntivi seguenti si applicano al tipo di dispositivo vcr :

MCI_VCR_LIST_AUDIO_SOURCE

Elencare gli input audio o i tipi.

MCI_VCR_LIST_COUNT

Imposta il membro dwReturn della struttura identificata da lpList sul numero totale di input video o audio.

MCI_VCR_LIST_NUMBER

Imposta il membro dwReturn della struttura identificata da lpList sul tipo di input video o audio specificato dal membro dwNumber .

MCI_VCR_LIST_VIDEO_SOURCE

Elencare gli input o i tipi di video.

Per i dispositivi VCR, lpList punta a una struttura MCI_VCR_LIST_PARMS.

Requisiti

Requisito	valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI