ITLegacyAddressMediaControl ::SetDevConfig, méthode (tapi3if.h)

Article
03/02/2024

La fonction SetDevConfig permet à l’application de restaurer la configuration d’un appareil de flux multimédia sur un appareil en ligne sur une configuration obtenue précédemment à l’aide de GetDevConfig.

Syntaxe

HRESULT SetDevConfig(
  [in] BSTR  pDeviceClass,
  [in] DWORD dwSize,
  [in] BYTE  *pDeviceConfig
);

Paramètres

[in] pDeviceClass

Pointeur vers BSTR contenant la classe d’appareil TAPI pour laquelle des informations de configuration sont nécessaires.

[in] dwSize

Taille du tableau de configuration.

[in] pDeviceConfig

Pointeur vers le tableau d’octets contenant les informations de configuration de l’appareil obtenues par un appel à GetDevConfig.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La méthode a réussi.
E_POINTER	Le paramètre pDeviceClass, pdwSize ou ppDeviceConfig n’est pas un pointeur valide.
E_INVALIDARG	Le paramètre pdwSize est égal à zéro.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Remarques

Cette méthode est un wrapper COM pour la fonction tapi 2.1 lineSetDevConfig .

Le GetID doit être effectué avant d’appeler cette méthode.

L’application doit utiliser SysAllocString pour allouer de la mémoire au paramètre pDeviceClass et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

Références croisées TAPI 2.1 : lineGetDevConfig, lineSetDevConfig