Compartilhar via


Atalhos e variações de comando

[O recurso associado a esta página, MCI, é um recurso herdado. Foi substituído pelo MediaPlayer. O 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 que seu aplicativo abriu ou para abrir um dispositivo sem emitir explicitamente um comando aberto (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 close "all" 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.

O uso de "all" é 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 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 para comandos específicos de 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 para o comando open .

Se um aplicativo usar o recurso de abertura automática para abrir um dispositivo, o aplicativo deverá marcar 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. O 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.
  • O MCI detecta uma falha.