comando info

Il comando info recupera una descrizione hardware da un dispositivo. Tutti i dispositivi MCI 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("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
); 

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato all'apertura del dispositivo.

lpszInfoType

Flag che identifica il tipo di informazioni necessarie. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando info e i flag usati da ogni tipo.

Valore Significato Significato
cdaudio info identityinfo upc product
digitalvideo qualità audio algorithmaudio qualityfileproductstill algorithmtill quality usageversionvideo algorithmvideo qualitywindow text
overlay fileproduct testo della finestra
sequencer copyrightfile nameproduct
Vcr product version
videodisk product
Waveaudio fileinput outputproduct

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

Valore Significato
algoritmo audio Restituisce il nome dell'algoritmo di compressione audio corrente.
qualità audio Restituisce il nome del descrittore di qualità audio corrente. Ciò potrebbe restituire "sconosciuto" se l'applicazione ha impostato parametri su valori specifici che non corrispondono alle qualità definite.
copyright Recupera l'informativa sul copyright del file MIDI dall'evento meta copyright.
file Recupera il nome del file utilizzato dal dispositivo composto. Se il dispositivo viene aperto senza un file e il comando di caricamento non è stato usato, viene restituita una stringa Null.
informazioni sull'identità Produce un identificatore univoco per il CD audio attualmente caricato nel lettore sottoposto a query.
info upc Produce l'UPC (Universal Product Code) codificato in un CD audio. UPC è una stringa di cifre. Potrebbe non essere disponibile per tutti i CD.
input Recupera la descrizione del dispositivo di input corrente. Restituisce "none" se un dispositivo di input non è impostato.
name Recupera il nome della sequenza dall'evento meta nome sequenza/traccia.
output Recupera la descrizione del dispositivo di output corrente. Restituisce "none" se un dispositivo di output non è impostato.
product Recupera una descrizione del dispositivo. Queste informazioni includono spesso il nome e il modello del prodotto. La lunghezza della stringa sarà di 31 caratteri o meno.
algoritmo ancora Restituisce il nome dell'algoritmo di compressione dell'immagine corrente.
qualità ancora Restituisce il nome del descrittore di qualità dell'immagine corrente. Ciò potrebbe restituire "sconosciuto" se l'applicazione ha impostato parametri su valori specifici che non corrispondono alle qualità definite.
utilizzo Restituisce una stringa che descrive le restrizioni di utilizzo che potrebbero essere imposte dal proprietario dei dati visivi o audio nell'area di lavoro.
version Restituisce il livello di rilascio del driver di dispositivo e dell'hardware.
algoritmo video Restituisce il nome dell'algoritmo di compressione video corrente.
qualità video Restituisce il nome del descrittore di qualità video corrente. Ciò potrebbe restituire "sconosciuto" se l'applicazione ha impostato parametri su valori specifici che non corrispondono alle qualità definite.
testo della finestra Recupera la didascalia della finestra utilizzata dal dispositivo.

lpszFlags

Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video e VCR, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Flag di attesa, notifica e test.

Valore restituito

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

Esempio

Il comando seguente recupera una descrizione dell'hardware associato al dispositivo "mysound".

info mysound product

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

carico