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	Mmsystem.h (incluir Windows.h)

Confira também

MCI

Comandos MCI