comando MCI_DELETE

O comando MCI_DELETE remove dados do arquivo. Os dispositivos de áudio de formato de onda e vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_DELETE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDelete
);

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT ou, para dispositivos de vídeo digital, MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpDelete

Ponteiro para uma estrutura MCI_GENERIC_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor Retornado

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

Comentários

Os seguintes sinalizadores se aplicam ao tipo de dispositivo digitalvideo :

MCI_DGV_DELETE_AT

Um retângulo é incluído no membro rc da estrutura identificada por lpDelete. O retângulo especifica a parte de cada quadro a ser excluído. Quando esse sinalizador é usado, o quadro é mantido no workspace e a área especificada pelo retângulo fica preta. Se o sinalizador for omitido, MCI_DELETE usará como padrão todo o quadro e removerá o quadro do workspace.

MCI_DGV_DELETE_AUDIO_STREAM

Um número de fluxo de áudio é incluído no membro dwAudioStream da estrutura identificada por lpDelete. Se você usar esse sinalizador e também quiser excluir o vídeo, também deverá usar o sinalizador MCI_DGV_DELETE_VIDEO_STREAM. (Se nenhum sinalizador for especificado, os dados de todos os fluxos de áudio e vídeo serão excluídos.)

MCI_DGV_DELETE_VIDEO_STREAM

Um número de fluxo de vídeo está incluído no membro dwVideoStream da estrutura identificada por lpDelete. Se você usar esse sinalizador e também quiser excluir o áudio, também deverá usar o sinalizador MCI_DGV_DELETE_AUDIO_STREAM. (Se nenhum sinalizador for especificado, os dados de todos os fluxos de áudio e vídeo serão excluídos.)

MCI_FROM

Um local inicial é incluído no membro dwFrom da estrutura identificada por lpDelete. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT do comando MCI_SET .

MCI_TO

Um local final é incluído no membro dwTo da estrutura identificada por lpDelete. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT de MCI_SET.

Para dispositivos de vídeo digital, o parâmetro lpDelete aponta para uma estrutura MCI_DGV_DELETE_PARMS .

Os seguintes sinalizadores se aplicam ao tipo de dispositivo waveaudio :

MCI_FROM

Um local inicial é incluído no membro dwFrom da estrutura identificada por lpDelete. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT de MCI_SET.

MCI_TO

Um local final é incluído no membro dwTo da estrutura identificada por lpDelete. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT de MCI_SET.

Para dispositivos de áudio de forma de onda, o parâmetro lpDelete aponta para uma estrutura MCI_WAVE_DELETE_PARMS .

Requisitos

Confira também

MCI

Comandos MCI