Compartilhar via


Comando delete

O comando delete exclui um segmento de dados de um arquivo. Os dispositivos de áudio de formato de onda e vídeo digital 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("delete %s %s %s"), 
  lpszDeviceID, 
  lpszPosition, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszPosition

Sinalizador que identifica um segmento de dados a ser excluído. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando delete e os sinalizadores usados por cada tipo.

Valor Significado Significado
digitalvideo
  • no retângulo
  • fluxo de áudio
  • da posição
  • para posicionar
  • fluxo de vídeo
Waveaudio da posição para posicionar

A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszPosition e seus significados.

Valor Significado
no retângulo Especifica a parte de cada quadro excluído. Se omitido, o padrão será todo o quadro. Quando este item é especificado, os quadros não são excluídos. Em vez disso, a área dentro do retângulo fica preta.
fluxo de áudio Especifica o fluxo de áudio no workspace afetado pelo comando . Se você usar esse sinalizador e também quiser excluir o vídeo, também deverá usar o sinalizador "fluxo de vídeo". (Se nenhum sinalizador for especificado, todos os fluxos de áudio e vídeo serão excluídos.)
da posição Especifica a posição na qual a exclusão começa. Se esse sinalizador for omitido, a exclusão começará na posição atual.
para posicionar Especifica a posição na qual a exclusão termina. Se esse sinalizador for omitido, a exclusão continuará até o final do conteúdo ou do workspace.
fluxo de vídeo Especifica o fluxo de vídeo no workspace afetado pelo comando . Se você usar esse sinalizador e também quiser excluir áudio, também deverá usar o sinalizador "fluxo de áudio". (Se nenhum sinalizador for especificado, todos os fluxos de áudio e vídeo serão excluídos.)

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.

Valor Retornado

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

Comentários

Antes de emitir comandos que usam valores de posição, você deve definir o formato de hora desejado usando o comando set .

Exemplos

O comando a seguir exclui os dados de áudio de forma de onda de 1 milissegundo a 900 milissegundos (supondo que o formato de hora esteja definido como milissegundos).

delete mysound from 1 to 900

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

set