Compartilhar via

Método ITMultiTrackTerminal::RemoveTrackTerminal (tapi3if.h)

  • Artigo

O método RemoveTrackTerminal remove o terminal especificado da coleção de terminais de faixa que pertencem ao terminal multitrack no qual o método foi chamado. Se o terminal de rastreamento tiver sido selecionado em um fluxo, ele deverá ser desmarcado primeiro.

Sintaxe

HRESULT RemoveTrackTerminal(
  [in] ITTerminal *pTrackTerminalToRemove
);

Parâmetros

[in] pTrackTerminalToRemove

Ponteiro para a interface ITTerminal do terminal a ser removida.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_POINTER
 O parâmetro pTrackTerminalToRemove não é um ponteiro válido.
E_OUTOFMEMORY
 Há memória insuficiente para executar a operação.

Comentários

O uso principal do método RemoveTrackTerminal é a limpeza durante o processo de seleção do terminal. Por exemplo, se uma faixa tiver sido criada, mas não tiver sido selecionada em um fluxo, esse método poderá ser usado para remover a faixa.

A ação real executada por esse método pode variar na implementação real do terminal. Por exemplo, chamar esse método em um Terminal de Gravação de Arquivos faz com que o fluxo de dados de arquivo correspondente seja removido do arquivo. A chamada a esse método em um Terminal de Reprodução de Arquivos falha porque seu conjunto de terminais é determinado exclusivamente pela configuração de arquivo e não pode ser alterado pelo chamador.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

ITMultiTrackTerminal

ITTerminal