Comando sysinfo

  • Artigo

O comando sysinfo recupera informações do sistema MCI. O comando sysinfo é um comando do sistema MCI; ele é interpretado diretamente pelo MCI.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

_stprintf_s(
  lpszCommand, 
  TEXT("sysinfo %s %s %s"), 
  lpszDeviceID, 
  lpszRequest, 
  lpszFlags
);

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI ou tipo de dispositivo. Se um tipo de dispositivo for especificado, ele deverá ser um nome de tipo de dispositivo MCI padrão, conforme listado no material de referência para o comando capability . Você pode especificar "todos" quando o sinalizador especificado em lpszRequest permitir essa possibilidade.

lpszRequest

Um dos sinalizadores a seguir.

Valor Significado
installname
 Retorna o nome listado no registro ou no arquivo de SYSTEM.INI usado para instalar o dispositivo aberto com o identificador de dispositivo especificado.
quantity
 Retorna o número de dispositivos MCI listados no registro ou no arquivo SYSTEM.INI do tipo especificado no parâmetro lpszDeviceID . Esse identificador de dispositivo deve ser um nome de tipo de dispositivo MCI padrão. Todos os dígitos após o tipo de dispositivo são ignorados. Especificar "all" para lpszDeviceID retorna o número total de dispositivos MCI no sistema.
quantidade aberta
 Retorna o número de dispositivos MCI abertos do tipo especificado em lpszDeviceID. Esse identificador de dispositivo deve ser um nome de tipo de dispositivo MCI padrão. Especificar "all" para lpszDeviceID retorna o número total de dispositivos MCI abertos no sistema.
índice de nome
 Retorna o nome de um dispositivo MCI. O identificador do dispositivo deve ser um nome de tipo de dispositivo MCI padrão. O índice varia de 1 até o número de dispositivos desse tipo. Se "all" for especificado para lpszDeviceID, o índice varia de 1 até o número total de dispositivos no sistema.
índice de nome aberto
 Retorna o nome de um dispositivo MCI aberto. O identificador do dispositivo deve ser um nome de tipo de dispositivo MCI padrão. O índice varia de 1 até o número de dispositivos abertos desse tipo de dispositivo. Se "all" for especificado para lpszDeviceID, o índice varia de 1 até o número total de dispositivos abertos no sistema.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital e VCR, "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Exemplos

O comando a seguir retorna o número de dispositivos de áudio waveform abertos.

sysinfo waveaudio quantity open

O comando a seguir retorna o nome (alias do dispositivo) do primeiro dispositivo de áudio waveform aberto.

sysinfo waveaudio name 1 open

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]

Confira também

MCI

Cadeias de caracteres de comando MCI

Capacidade