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
);
-
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.
Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.
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.
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|