ITMultiTrackTerminal::RemoveTrackTerminal-Methode (tapi3if.h)
Die RemoveTrackTerminal-Methode entfernt das angegebene Terminal aus der Auflistung der Spurterminals, die zum Multitrack-Terminal gehören, für das die Methode aufgerufen wurde. Wenn das Spurterminal für einen Stream ausgewählt wurde, sollte es zuerst deaktiviert werden.
Syntax
HRESULT RemoveTrackTerminal(
[in] ITTerminal *pTrackTerminalToRemove
);
Parameter
[in] pTrackTerminalToRemove
Zeiger auf die ITTerminal-Schnittstelle des zu entfernenden Terminals.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Der pTrackTerminalToRemove-Parameter ist kein gültiger Zeiger. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
Hinweise
Die primäre Verwendung der RemoveTrackTerminal-Methode wird während des Terminalauswahlprozesses bereinigt. Wenn beispielsweise ein Track erstellt wurde, aber nicht für einen Stream ausgewählt wurde, kann diese Methode verwendet werden, um die Spur zu entfernen.
Die tatsächliche Aktion, die von dieser Methode ausgeführt wird, kann in der tatsächlichen Implementierung des Terminals variieren. Für instance führt das Aufrufen dieser Methode in einem Dateiaufzeichnungsterminal dazu, dass der entsprechende Dateidatenstrom aus der Datei entfernt wird. Beim Aufrufen dieser Methode in einem Terminal für die Dateiwiedergabe tritt ein Fehler auf, da derEn Terminalsatz ausschließlich durch die Dateikonfiguration bestimmt wird und vom Aufrufer nicht geändert werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |