Compartilhar via


Atalhos e variações de comando

[O recurso associado a esta página, mci, é um recurso herdado. Foi substituído por MediaPlayer. MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use mediaplayer em vez de mci, quando 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 abertos pelo aplicativo ou abrir um dispositivo sem emitir explicitamente um comando open (MCI_OPEN).

Você pode especificar "todos" (MCI_ALL_DEVICE_ID) como um identificador de dispositivo para qualquer comando que não retorne informações. Quando você especifica "todos", 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 reproduzir "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, a MCI tenta abrir o dispositivo antes de implementar o comando. As regras a seguir se aplicam à abertura automática de dispositivos:

  • O recurso de abertura automática funciona apenas com a interface de cadeia de caracteres de comando.
  • O recurso de abertura automática falha em comandos específicos para drivers de dispositivo personalizados.
  • Os dispositivos abertos automaticamente não respondem a comandos que usam "todos" como um nome de dispositivo.
  • O recurso de abertura automática não permite que seu aplicativo especifique o sinalizador de "tipo". Sem o nome do dispositivo, o MCI determina o nome do dispositivo das entradas no registro. 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 do comando open.

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

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