ITMediaCollection :: Create, méthode
[les interfaces et les contrôles de conférence de téléphonie IP Rendezvous ne sont pas disponibles pour une utilisation dans Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’API cliente RTC offre des fonctionnalités similaires.]
La méthode Create crée un nouveau média avec les propriétés par défaut, l’ajoute à la collection à l’index spécifié et retourne un pointeur vers l’interface ITMedia .
Syntaxe
HRESULT Create(
[in] LONG Index,
[out] ITMedia **ppMedia
);
Paramètres
-
Index [ dans]
-
Index du nouvel élément. La valeur minimale pour l’index est 1, et la valeur maximale pour l’index est le nombre actuel d’éléments + 1.
-
ppMedia [ à]
-
Pointeur vers l’interface ITMedia créée.
Valeur de retour
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
Le paramètre ppMedia n’est pas un pointeur valide. |
|
Le paramètre d' index n’est pas valide. |
|
La mémoire disponible est insuffisante pour effectuer l’opération. |
|
Erreur non spécifiée. |
|
Cette méthode n'est pas encore implémentée. |
Notes
la plupart des listes C et C++ sont de base 0, mais cet index est basé sur 1 pour la compatibilité Visual Basic, ce qui signifie que le premier élément a un numéro d’index de 1.
L’interface TAPI appelle la méthode AddRef sur l’interface ITMedia retournée par ITMediaCollection :: Create. L’application doit appeler Release sur l’interface ITMedia pour libérer les ressources qui lui sont associées.
Spécifications
| Condition requise | Valeur |
|---|---|
| Version TAPI |
Nécessite TAPI 3,0 ou une version ultérieure |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|