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
_OK
La méthode a réussi.
_pointeur E
Le paramètre ppMedia n’est pas un pointeur valide.
E _ INVALIDARG
Le paramètre d' index n’est pas valide.
_OUTOFMEMORY E
La mémoire disponible est insuffisante pour effectuer l’opération.
E _ échec
Erreur non spécifiée.
_NOTIMPL 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
Sdpblb. h
Bibliothèque
UUID. lib
DLL
Sdpblb.dll

Voir aussi

ITMedia

ITMediaCollection