ITLegacyAddressMediaControl ::GetDevConfig, méthode (tapi3if.h)
La méthode GetDevConfig retourne une structure de données opaque. Le contenu exact est spécifique au fournisseur de services et à la classe d’appareil. La structure de données spécifie la configuration d’un appareil associé à un appareil de ligne particulier. Par exemple, le contenu de cette structure peut spécifier le débit de données, le format de caractères, les schémas de modulation et les paramètres de protocole de contrôle d’erreur pour un appareil datamodem associé à la ligne.
Syntaxe
HRESULT GetDevConfig(
[in] BSTR pDeviceClass,
[out] DWORD *pdwSize,
[out] BYTE **ppDeviceConfig
);
Paramètres
[in] pDeviceClass
Pointeur vers BSTR contenant la classe d’appareil TAPI pour laquelle des informations de configuration sont nécessaires.
[out] pdwSize
Pointeur vers la taille du tableau de configuration.
[out] ppDeviceConfig
Pointeur vers le tableau d’octets contenant des informations de configuration d’appareil.
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 pDeviceClass, pdwSize ou ppDeviceConfig n’est pas un pointeur valide. |
|
La mémoire est insuffisante pour effectuer l’opération. |
Remarques
Cette méthode est un wrapper COM pour la fonction TAPI LineGetDevConfig 2.1.
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.
L’application doit appeler la fonction CoTaskMemFree pour libérer la mémoire allouée au paramètre ppDeviceConfig .
Références croisées TAPI 2.1 : lineGetDevConfig, lineSetDevConfig
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |