Compartilhar via


Comando close

O comando close fecha o dispositivo ou arquivo e todos os recursos associados. O MCI descarrega um dispositivo quando todas as instâncias do dispositivo ou todos os arquivos são fechados. Todos os dispositivos MCI reconhecem esse comando.

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

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

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Para fechar todos os dispositivos abertos pelo aplicativo, especifique o identificador de dispositivo "todos" para o parâmetro lpszDeviceID .

Fechar o dispositivo cdaudio interrompe a reprodução de áudio.

Windows 2000/XP: Se o dispositivo cdaudio estiver sendo reproduzido, fechar o dispositivo cdaudio não fará com que o áudio pare de ser reproduzido. Envie o comando stop primeiro.

Exemplos

O comando a seguir fecha o dispositivo "mysound".

close mysound

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
Corecrt_io.h

Confira também

MCI

Cadeias de caracteres de comando MCI