Leggere in inglese

Condividi tramite


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