comando MCI_SYSINFO

Il comando MCI_SYSINFO recupera informazioni sui dispositivi MCI. MCI supporta questo comando direttamente anziché passarlo al dispositivo. Qualsiasi applicazione MCI può usare questo comando. Le informazioni sulla stringa vengono restituite nel buffer fornito dall'applicazione a cui punta il membro lpstrReturn della struttura identificata da lpSysInfo. Le informazioni numeriche vengono restituite come valore DWORD inserito nel buffer fornito dall'applicazione. Il membro dwRetSize specifica la lunghezza del buffer.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SYSINFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);

Parametri

wDeviceID

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

Dwflags

Uno o più dei flag standard e specifici del comando seguenti:

MCI_SYSINFO_INSTALLNAME

Ottiene il nome (elencato nel Registro di sistema o nel file di SYSTEM.INI) usato per installare il dispositivo.

MCI_SYSINFO_NAME

Ottiene un nome di dispositivo corrispondente al numero di dispositivo specificato nel membro dwNumber della struttura identificata dalpSysInfo. Se il flag MCI_SYSINFO_OPEN è impostato, MCI restituisce i nomi dei dispositivi aperti.

MCI_SYSINFO_OPEN

Ottiene la quantità o il nome dei dispositivi aperti.

MCI_SYSINFO_QUANTITY

Ottiene il numero di dispositivi del tipo specificato elencati nel Registro di sistema o nella sezione [mci] del file SYSTEM.INI. Se il flag MCI_SYSINFO_OPEN è impostato, viene restituito il numero di dispositivi aperti.

lpSysInfo

Puntatore a una struttura MCI_SYSINFO_PARMS .

Valore restituito

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

Commenti

Il membro wDeviceType della struttura identificata da lpSysInfo viene usato per indicare il tipo di dispositivo della query. Se il parametro wDeviceID è impostato su MCI_ALL_DEVICE_ID, esegue l'override del valore di wDeviceType. Per un elenco dei tipi di dispositivo, vedere Tipi di dispositivo MCI.

I valori restituiti integer sono valori DWORD restituiti nel buffer a cui punta il membro lpstrReturn della struttura identificata da lpSysInfo.

I valori restituiti dalla stringa sono stringhe con terminazione Null restituite nel buffer a cui punta il membro lpstrReturn della struttura identificata da lpSysInfo.

Requisiti

Vedi anche

MCI

Comandi MCI