Condividi tramite


Metodo ITMultiTrackTerminal::RemoveTrackTerminal (tapi3if.h)

Il metodo RemoveTrackTerminal rimuove il terminale specificato dalla raccolta di terminali di traccia appartenenti al terminale multitraccia in cui è stato chiamato il metodo . Se il terminale di traccia è stato selezionato in un flusso, deve essere deselezionato per primo.

Sintassi

HRESULT RemoveTrackTerminal(
  [in] ITTerminal *pTrackTerminalToRemove
);

Parametri

[in] pTrackTerminalToRemove

Puntatore all'interfaccia ITTerminal del terminale da rimuovere.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
E_POINTER
Il parametro pTrackTerminalToRemove non è un puntatore valido.
E_OUTOFMEMORY
Memoria insufficiente per eseguire l'operazione.

Commenti

L'uso principale del metodo RemoveTrackTerminal è la pulizia durante il processo di selezione del terminale. Ad esempio, se è stata creata una traccia, ma non è stata selezionata in un flusso, questo metodo può essere usato per rimuovere la traccia.

L'azione effettiva eseguita da questo metodo può variare nell'implementazione effettiva del terminale. Ad esempio, chiamando questo metodo in un terminale di registrazione file, il flusso di dati del file corrispondente viene rimosso dal file. La chiamata a questo metodo su un terminale di riproduzione file ha esito negativo perché il set di terminali è determinato esclusivamente dalla configurazione del file e non può essere modificato dal chiamante.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi3if.h (include Tapi3.h)
Libreria Uuid.lib
DLL Tapi3.dll

Vedi anche

ITMultiTrackTerminal

ITTerminal