Partilhar via


Atalhos e variações de comando

[O recurso associado a esta página, MCI, é um recurso legado. Foi substituído por MediaPlayer. MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize MediaPlayer em vez de MCI, sempre que possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Você pode usar vários atalhos ao trabalhar com comandos MCI. Esses atalhos permitem que você use um único identificador para se referir a todos os dispositivos que seu aplicativo abriu, ou para abrir um dispositivo sem emitir explicitamente um comando open (MCI_OPEN).

Você pode especificar "all" (MCI_ALL_DEVICE_ID) como um identificador de dispositivo para qualquer comando que não retorne informações. Quando você especifica "all", o MCI envia o comando sequencialmente para todos os dispositivos abertos pelo aplicativo atual.

Por exemplo, o comando fechar "todos" fecha todos os dispositivos abertos e o comando play "todos" começa a reproduzir todos os dispositivos abertos pelo aplicativo. Como o MCI envia sequencialmente os comandos para os dispositivos MCI, há um intervalo entre quando o primeiro e o último dispositivos recebem o comando.

Usar "todos" é uma maneira conveniente de transmitir um comando para todos os seus dispositivos, mas você não deve confiar nele para sincronizar dispositivos; O tempo entre as mensagens pode variar.

Quando você emite um comando e especifica um dispositivo que não está aberto, o MCI tenta abrir o dispositivo antes de implementar o comando. As seguintes regras aplicam-se aos dispositivos de abertura automática:

  • O recurso de abertura automática funciona apenas com a interface de cadeia de comando.
  • O recurso de abertura automática falha para comandos específicos de drivers de dispositivo personalizados.
  • Os dispositivos abertos automaticamente não respondem a comandos que usam "todos" como nome de dispositivo.
  • O recurso de abertura automática não permite que seu aplicativo especifique o sinalizador "tipo". Sem o nome do dispositivo, o MCI determina o nome do dispositivo a partir das entradas no registo. Para usar um dispositivo específico, você pode combinar o nome do dispositivo com o nome do arquivo usando o ponto de exclamação, conforme descrito no material de referência para o comando open.

Se um aplicativo usa o recurso de abertura automática para abrir um dispositivo, o aplicativo deve verificar o valor de retorno de cada comando aberto subsequente para verificar se o dispositivo ainda está aberto. O MCI também fecha automaticamente qualquer dispositivo que abra automaticamente. MCI normalmente fecha um dispositivo nas seguintes situações:

  • O comando é concluído.
  • Você anula o comando.
  • Você solicita notificação em um comando subsequente.
  • O MCI deteta uma falha.