ITMultiTrackTerminal ::RemoveTrackTerminal, méthode (tapi3if.h)
La méthode RemoveTrackTerminal supprime le terminal spécifié de la collection de terminaux de suivi qui appartiennent au terminal multipiste sur lequel la méthode a été appelée. Si le terminal de suivi a été sélectionné sur un flux, il doit d’abord être désélectionné.
Syntaxe
HRESULT RemoveTrackTerminal(
[in] ITTerminal *pTrackTerminalToRemove
);
Paramètres
[in] pTrackTerminalToRemove
Pointeur vers l’interface ITTerminal du terminal à supprimer.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La méthode a réussi. |
|
Le paramètre pTrackTerminalToRemove n’est pas un pointeur valide. |
|
La mémoire est insuffisante pour effectuer l’opération. |
Remarques
L’utilisation principale de la méthode RemoveTrackTerminal est le nettoyage pendant le processus de sélection du terminal. Par exemple, si une piste a été créée, mais qu’elle n’a pas été sélectionnée sur un flux, cette méthode peut être utilisée pour supprimer la piste.
L’action réelle effectuée par cette méthode peut varier dans l’implémentation réelle du terminal. Par instance, l’appel de cette méthode sur un terminal d’enregistrement de fichiers entraîne la suppression du flux de données de fichier correspondant du fichier. L’appel de cette méthode sur un terminal de lecture de fichiers échoue, car son ensemble de terminaux est déterminé uniquement par la configuration de fichier et ne peut pas être modifié par l’appelant.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |