comando list

Il comando elenco determina il numero e i tipi di input video e audio. I dispositivi digital-video e VCR 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("list %s %s %s"), 
  lpszDeviceID, 
  lpszList, 
  lpszFlags
); 

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato quando il dispositivo viene aperto.

lpszList

Flag che identifica il numero e i tipi di input video e audio. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando elenco e i flag usati da ogni tipo.

Valore	Significato	Significato
digitalvideo	Indice audio algorithmaudio quality algoritmoaudio streamcountber	algoritmo di qualità dell'algoritmodi qualità degli algoritmi di ancoraalgoritmi video di origine video
Vcr	indice del numero di origine audio	indice del numero di origine video del numero di origine video

Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszList e nei relativi significati.

Valore	Significato
algoritmo audio	Specifica il comando deve recuperare i nomi degli algoritmi audio.
algoritmo di qualità audio	Specifica che il comando deve recuperare i livelli di qualità associati all'algoritmo specificato. Se l'algoritmo è "corrente", viene restituito il livello di qualità dell'algoritmo corrente.
numero di origini audio	Restituisce il numero totale di input audio.
indice del numero di origine audio	Restituisce il tipo di input audio dell'indice di origine.
flusso audio	Specifica che il comando deve recuperare i nomi dei flussi audio associati all'area di lavoro. Queste stringhe (ad esempio "inglese" o "tedesco") sono incorporate nel file e identificano il flusso.
count	Restituisce il numero di opzioni del tipo specificato.
indice numerico	Restituisce una stringa che descrive un'opzione specifica (identificata dall'indice) del tipo di opzione specificato. L'indice deve essere un intero compreso tra 1 e il valore restituito da "count".
algoritmo ancora	Specifica che il comando deve recuperare i nomi degli algoritmi ancora.
algoritmo di qualità ancora	Specifica che il comando deve recuperare i livelli di qualità associati all'algoritmo ancora specificato. Se l'algoritmo è "corrente", viene restituito il livello di qualità dell'algoritmo corrente.
algoritmo video	Specifica il comando deve recuperare i nomi degli algoritmi video.
algoritmo di qualità video	Specifica che il comando deve recuperare i livelli di qualità associati all'algoritmo video specificato. Se l'algoritmo è "corrente", viene restituito il livello di qualità dell'algoritmo corrente.
origine video	Specifica che il comando deve restituire informazioni sulle origini video. Se usato con il flag "count", restituisce il numero di origini video. Se usato con il flag "number", restituisce il tipo di origine video. MCI definisce le costanti seguenti per il tipo: "ntsc", "rgb", "pal", "secam", "svideo" e "generic". Potrebbe essere presente più di un'origine di ogni tipo restituito. Il tipo di origine "generico" viene usato quando per tale connettore è consentito più di un segnale.
conteggio origine video	Restituisce il numero totale di input video.
indice del numero di origine video	Restituisce il tipo di input video dell'indice di origine.
flusso video	Specifica il comando deve recuperare i nomi dei flussi video associati all'area di lavoro. Queste stringhe (ad esempio "terminazioni divertenti" o "fine triste") sono incorporate nel file e identificano il flusso.

lpszFlags

Può essere "wait", "notify" o "test". Per altre informazioni su questi flag, vedere Attesa, notifica e flag di test.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

Per i dispositivi VCR, è necessario specificare "origine video" o "origine audio" con i flag "count" o "number". Se viene specificato "count", viene restituito il numero totale di input di video o audio. Se viene specificato "number", il driver restituisce un tipo corrispondente all'input. Il tipo può essere uno dei seguenti: "tuner", "line", "svideo", "aux" o "generic". In genere, è necessario eseguire prima una query sul registro virtuale per il "conteggio" e quindi usare il conteggio come intervallo per il flag "number". I numeri di "origine" iniziano da 1.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI