comando MCI_INFO

Il comando MCI_INFO recupera le informazioni sulle stringhe da un dispositivo. Tutti i dispositivi riconoscono questo comando. Le informazioni vengono restituite nel membro lpstrReturn della struttura identificata da lpInfo. Il membro dwRetSize specifica la lunghezza del buffer per i dati restituiti.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

Parametri

wDeviceID

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

Dwflags

MCI_NOTIFY, MCI_WAIT o per i dispositivi digital-video e VCR, MCI_TEST. Per informazioni su questi flag, vedere Flag di attesa, notifica e test.

lpInfo

Puntatore a una struttura MCI_INFO_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 standard e specifico del comando seguente si applica a tutti i dispositivi che supportano MCI_INFO:

MCI_INFO_PRODUCT

Ottiene una descrizione dell'hardware associato a un dispositivo. I dispositivi devono fornire una descrizione che identifica sia il driver che l'hardware usato.

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

MCI_INFO_MEDIA_IDENTITY

Produce un identificatore univoco per il CD audio attualmente caricato nel lettore sottoposto a query. Questo flag restituisce una stringa di 16 cifre esadecimali.

MCI_INFO_MEDIA_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.

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

MCI_DGV_INFO_ITEM

Una costante che indica le informazioni desiderate è inclusa nel membro dwItem della struttura identificata da lpInfo. Le costanti seguenti sono definite per i dispositivi digital-video:

MCI_DGV_INFO_AUDIO_ALG

Restituisce il nome dell'algoritmo di compressione audio corrente.

MCI_DGV_INFO_AUDIO_QUALITY

Restituisce il nome del descrittore di qualità audio corrente.

MCI_DGV_INFO_STILL_ALG

Restituisce il nome dell'algoritmo di compressione dell'immagine corrente.

MCI_DGV_INFO_STILL_QUALITY

Restituisce il nome del descrittore di qualità dell'immagine corrente.

MCI_DGV_INFO_USAGE

Restituisce una stringa che descrive le restrizioni di utilizzo che possono essere imposte dal proprietario dell'oggetto visivo o dei dati udibili nell'area di lavoro.

MCI_DGV_INFO_VIDEO_ALG

Restituisce il nome dell'algoritmo di compressione video corrente.

MCI_DGV_INFO_VIDEO_QUALITY

Restituisce il nome del descrittore di qualità video corrente.

MCI_INFO_VERSION

Restituisce il livello di rilascio del driver di dispositivo e dell'hardware. Gli sviluppatori di driver di dispositivo devono documentare la sintassi della stringa restituita.

MCI_DGV_INFO_TEXT

Ottiene il didascalia della finestra.

MCI_INFO_FILE

Ottiene il percorso e il nome file dell'ultimo file specificato con il comando MCI_OPEN o MCI_LOAD . Se non è stato specificato un file, il dispositivo restituisce una stringa con terminazione Null. Questo flag è supportato solo dai dispositivi che restituiscono TRUE al flag MCI_GETDEVCAPS_USES_FILES del comando MCI_GETDEVCAPS .

Per i dispositivi digital-video, lpInfo punta a una struttura MCI_DGV_INFO_PARMS .

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

MCI_INFO_COPYRIGHT

Ottiene l'informativa sul copyright del file MIDI dall'evento meta copyright.

MCI_INFO_FILE

Ottiene il nome file del file corrente. Questo flag è supportato solo dai dispositivi che restituiscono TRUE quando si chiama il comando MCI_GETDEVCAPS con il flag MCI_GETDEVCAPS_USES_FILES.

MCI_INFO_NAME

Ottiene il nome della sequenza dall'evento meta nome sequenza/traccia.

Il flag aggiuntivo seguente si applica al tipo di dispositivo vcr :

MCI_VCR_INFO_VERSION

Imposta il membro lpstrReturn della struttura MCI_INFO_PARMS in modo che punti al numero di versione. Imposta anche il membro dwRetSize uguale alla lunghezza della stringa a cui punta.

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

MCI_INFO_FILE

Ottiene il nome file del file corrente. Questo flag è supportato solo dai dispositivi che restituiscono TRUE al flag MCI_GETDEVCAPS_USES_FILES del comando MCI_GETDEVCAPS .

MCI_OVLY_INFO_TEXT

Ottiene la didascalia della finestra associata al dispositivo di sovrapposizione video.

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

MCI_INFO_FILE

Ottiene il nome file del file corrente. Questo flag è supportato dai dispositivi che restituiscono TRUE quando si chiama il comando MCI_GETDEVCAPS con il flag MCI_GETDEVCAPS_USES_FILES.

MCI_WAVE_INPUT

Ottiene il nome del prodotto dell'input corrente.

MCI_WAVE_OUTPUT

Ottiene il nome del prodotto dell'output corrente e il relativo valore è specifico del dispositivo.

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