Condividi tramite


comando MCI_GETDEVCAPS

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