comando MCI_SYSINFO
O comando MCI_SYSINFO recupera informações sobre dispositivos MCI. O MCI dá suporte a esse comando diretamente em vez de passá-lo para o dispositivo. Qualquer aplicativo MCI pode usar esse comando. As informações de cadeia de caracteres são retornadas no buffer fornecido pelo aplicativo apontado pelo membro lpstrReturn da estrutura identificada por lpSysInfo. As informações numéricas são retornadas como um valor DWORD colocado no buffer fornecido pelo aplicativo. O membro dwRetSize especifica o comprimento do buffer.
Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SYSINFO,
DWORD dwFlags,
(DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);
Parâmetros
-
wDeviceID
-
Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.
-
dwFlags
-
Um ou mais dos seguintes sinalizadores padrão e específicos do comando:
-
MCI_SYSINFO_INSTALLNAME
-
Obtém o nome (listado no registro ou no arquivo de SYSTEM.INI) usado para instalar o dispositivo.
-
MCI_SYSINFO_NAME
-
Obtém um nome de dispositivo correspondente ao número do dispositivo especificado no membro dwNumber da estrutura identificada porlpSysInfo. Se o sinalizador MCI_SYSINFO_OPEN estiver definido, a MCI retornará os nomes dos dispositivos abertos.
-
MCI_SYSINFO_OPEN
-
Obtém a quantidade ou o nome dos dispositivos abertos.
-
MCI_SYSINFO_QUANTITY
-
Obtém o número de dispositivos do tipo especificado listados no registro ou na seção [mci] do arquivo SYSTEM.INI. Se o sinalizador MCI_SYSINFO_OPEN estiver definido, o número de dispositivos abertos será retornado.
-
lpSysInfo
-
Ponteiro para uma estrutura MCI_SYSINFO_PARMS .
Valor Retornado
Retornará zero se tiver êxito ou um erro, caso contrário.
Comentários
O membro wDeviceType da estrutura identificada por lpSysInfo é usado para indicar o tipo de dispositivo da consulta. Se o parâmetro wDeviceID for definido como MCI_ALL_DEVICE_ID, ele substituirá o valor de wDeviceType. Para obter uma lista de tipos de dispositivo, consulte Tipos de dispositivo MCI.
Valores retornados inteiros são valores DWORD retornados no buffer apontado pelo membro lpstrReturn da estrutura identificada por lpSysInfo.
Os valores retornados da cadeia de caracteres são cadeias de caracteres terminadas em nulo retornadas no buffer apontado pelo membro lpstrReturn da estrutura identificada por lpSysInfo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|