comando MCI_GETDEVCAPS

Articolo
06/13/2023

Il comando MCI_GETDEVCAPS recupera informazioni statiche su un dispositivo. Tutti i dispositivi riconoscono questo comando. I parametri e i flag disponibili per questo comando dipendono dal dispositivo selezionato. Le informazioni vengono restituite nel membro dwReturn della struttura identificata da lpCapsParms.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

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.
lpCapsParms: Puntatore a una struttura MCI_GETDEVCAPS_PARMS .

Valore restituito

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

Commenti

I flag standard e specifici del comando seguenti si applicano a tutti i dispositivi che supportano MCI_GETDEVCAPS:

MCI_GETDEVCAPS_COMPOUND_DEVICE: Il membro dwReturn è impostato su TRUE se il dispositivo usa l'archiviazione dati che deve essere aperta e chiusa in modo esplicito; è impostata su FALSE in caso contrario.
MCI_GETDEVCAPS_DEVICE_TYPE: Il membro dwReturn è impostato su uno dei valori elencati in Tipi di dispositivo MCI.
MCI_GETDEVCAPS_HAS_AUDIO: Il membro dwReturn è impostato su TRUE se il dispositivo ha output audio; è impostata su FALSE in caso contrario.
MCI_GETDEVCAPS_HAS_VIDEO: Il membro dwReturn è impostato su TRUE se il dispositivo ha output video; è impostata su FALSE in caso contrario. Ad esempio, il membro è impostato su TRUE per i dispositivi che supportano il set di comandi di videodisc.
MCI_GETDEVCAPS_ITEM: Specifica che il membro dwItem della struttura MCI_GETDEVCAPS_PARMS contiene una delle costanti seguenti:
MCI_GETDEVCAPS_CAN_EJECT: Il membro dwReturn è impostato su TRUE se il dispositivo può espellere il supporto; in caso contrario, è impostato su FALSE.
MCI_GETDEVCAPS_CAN_PLAY: Il membro dwReturn è impostato su TRUE se il dispositivo può riprodurre il supporto; in caso contrario, è impostato su FALSE. Se un dispositivo specifica TRUE, implica che il dispositivo supporti i comandi MCI_PAUSE e MCI_STOP , nonché il comando MCI_PLAY .
MCI_GETDEVCAPS_CAN_RECORD: Il membro dwReturn è impostato su TRUE se il dispositivo supporta la registrazione; in caso contrario, è impostato su FALSE. Se un dispositivo specifica TRUE, implica che il dispositivo supporti i comandi MCI_PAUSE e MCI_STOP, nonché il comando MCI_RECORD .
MCI_GETDEVCAPS_CAN_SAVE: Il membro dwReturn è impostato su TRUE se il dispositivo può salvare un file; in caso contrario, è impostato su FALSE.
MCI_GETDEVCAPS_USES_FILES: Il membro dwReturn è impostato su TRUE se il dispositivo richiede un nome file; è impostata su FALSE in caso contrario. Solo i dispositivi composti usano file.

I flag seguenti possono essere specificati nel membro dwItem di MCI_GETDEVCAPS_PARMS per il tipo di dispositivo digitalvideo :

MCI_DGV_GETDEVCAPS_CAN_FREEZE: Il membro dwReturn è impostato su TRUE se il dispositivo può bloccare i fotogrammi; in caso contrario, è impostato su FALSE.
MCI_DGV_GETDEVCAPS_CAN_LOCK: Il membro dwReturn è impostato su TRUE se il dispositivo può bloccare; in caso contrario, è impostato su FALSE.
MCI_DGV_GETDEVCAPS_CAN_REVERSE: Il membro dwReturn è impostato su TRUE se il dispositivo può essere riprodotto inverso; in caso contrario, è impostato su FALSE.
MCI_DGV_GETDEVCAPS_CAN_STR_IN: Il membro dwReturn è impostato su TRUE se il dispositivo può estendere l'input; in caso contrario, è impostato su FALSE.
MCI_DGV_GETDEVCAPS_CAN_STRETCH: Il membro dwReturn è impostato su TRUE se il dispositivo può estendere un'immagine; in caso contrario, è impostato su FALSE.
MCI_DGV_GETDEVCAPS_CAN_TEST: Il membro dwReturn è impostato su TRUE se il dispositivo può eseguire test; in caso contrario, è impostato su FALSE.
MCI_DGV_GETDEVCAPS_HAS_STILL: Il membro dwReturn è impostato su TRUE se il dispositivo può visualizzare ancora immagini; in caso contrario, è impostato su FALSE.
MCI_DGV_GETDEVCAPS_MAX_WINDOWS: Il membro dwReturn è impostato sul numero massimo di finestre che il dispositivo può gestire contemporaneamente.
MCI_DGV_GETDEVCAPS_MAXIMUM_RATE: Il membro dwReturn è impostato sulla frequenza di riproduzione massima per il dispositivo, in fotogrammi al secondo.
MCI_DGV_GETDEVCAPS_MINIMUM_RATE: Il membro dwReturn è impostato sulla frequenza di riproduzione minima per il dispositivo, in fotogrammi al secondo.
MCI_DGV_GETDEVCAPS_PALETTES: Il membro dwReturn è impostato su TRUE se il dispositivo può restituire un handle di tavolozza; in caso contrario, è impostato su FALSE.

I flag seguenti possono essere specificati nel membro dwItem di MCI_GETDEVCAPS_PARMS per il tipo di dispositivo vcr :

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE: Il membro dwReturn viene impostato sul numero di incrementi al secondo.
MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH: Il membro dwReturn è impostato su TRUE se il dispositivo è in grado di rilevare la lunghezza del supporto; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_CAN_FREEZE: Il membro dwReturn è impostato su TRUE se il dispositivo è in grado di bloccare l'immagine di output; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES: Il membro dwReturn è impostato su TRUE se il dispositivo è in grado di monitorare le origini; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_CAN_PREROLL: Il membro dwReturn è impostato su TRUE se il dispositivo è in grado di preroll; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_CAN_PREVIEW: Il membro dwReturn è impostato su TRUE se il dispositivo è in grado di visualizzare le anteprime; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_CAN_REVERSE: Il membro dwReturn è impostato su TRUE se il dispositivo è in grado di giocare inversa; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_CAN_TEST: Il membro dwReturn è impostato su TRUE se il dispositivo è in grado di testare; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_HAS_CLOCK: Il membro dwReturn è impostato su TRUE se il dispositivo supporta un orologio esterno; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_HAS_TIMECODE: Il membro dwReturn è impostato su TRUE se il dispositivo ha funzionalità di timecode o se questa funzionalità è sconosciuta; in caso contrario, è impostato su FALSE.
MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS: Il membro dwReturn è impostato sul numero di contrassegni (99).
MCI_VCR_GETDEVCAPS_SEEK_ACCURACY: Il membro dwReturn è impostato sull'accuratezza di ricerca del dispositivo.

I flag seguenti possono essere specificati nel membro dwItem di MCI_GETDEVCAPS_PARMS per il tipo di dispositivo overlay :

MCI_OVLY_GETDEVCAPS_CAN_FREEZE: Il membro dwReturn è impostato su TRUE se il dispositivo può bloccare l'immagine; in caso contrario, è impostato su FALSE.
MCI_OVLY_GETDEVCAPS_CAN_STRETCH: Il membro dwReturn è impostato su TRUE se il dispositivo può estendere l'immagine per riempire il frame; in caso contrario, è impostato su FALSE.
MCI_OVLY_GETDEVCAPS_MAX_WINDOWS: Il membro dwReturn è impostato sul numero massimo di finestre che il dispositivo può gestire contemporaneamente.

I flag seguenti possono essere specificati nel membro dwItem di MCI_GETDEVCAPS_PARMS per il tipo di dispositivo videodisc :

MCI_VD_GETDEVCAPS_CAN_REVERSE: Il membro dwReturn è impostato su TRUE se il lettore videodisce può essere riprodotto inverso; in caso contrario, è impostato su FALSE. Alcuni lettori possono riprodurre dischi CLV inversa e dischi CAV.
MCI_VD_GETDEVCAPS_CAV: In combinazione con altri elementi, specifica che le informazioni restituite si applicano ai videodiscs in formato CAV. Si tratta dell'impostazione predefinita se non viene inserito alcun videodisc.
MCI_VD_GETDEVCAPS_CLV: In combinazione con altri elementi, specifica che le informazioni restituite si applicano ai videodiscs in formato CLV.
MCI_VD_GETDEVCAPS_FAST_RATE: Il membro dwReturn è impostato sulla velocità di riproduzione veloce standard in fotogrammi al secondo.
MCI_VD_GETDEVCAPS_NORMAL_RATE: Il membro dwReturn è impostato sulla frequenza di riproduzione normale in fotogrammi al secondo.
MCI_VD_GETDEVCAPS_SLOW_RATE: Il membro dwReturn è impostato sulla frequenza di riproduzione lenta standard in fotogrammi al secondo.

I flag seguenti possono essere specificati nel membro dwItem di MCI_GETDEVCAPS_PARMS per il tipo di dispositivo waveaudio :

MCI_WAVE_GETDEVCAPS_INPUT: Il membro dwReturn viene impostato sul numero totale di dispositivi di input (registrazione) della forma dw.
MCI_WAVE_GETDEVCAPS_OUTPUT: Il membro dwReturn è impostato sul numero totale di dispositivi di output waveform (riproduzione).

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