Méthode IControlInterface::GetName (devicetopology.h)
La méthode GetName obtient le nom convivial de la fonction audio encapsulée par l’interface de contrôle.
HRESULT GetName(
[out] LPWSTR *ppwstrName
);
[out] ppwstrName
Pointeur vers un pointeur de chaîne dans lequel la méthode écrit l’adresse d’une chaîne à caractères larges terminée par null qui contient le nom convivial. La méthode alloue le stockage pour la chaîne. L’appelant est responsable de libérer le stockage, lorsqu’il n’est plus nécessaire, en appelant la fonction CoTaskMemFree . Si l’appel GetName échoue, *ppwstrName a la valeur NULL. Pour plus d’informations sur CoTaskMemFree, consultez la documentation du Kit de développement logiciel (SDK) Windows.
Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.
Code de retour | Description |
---|---|
|
Le pointeur ppwstrName a la valeur NULL. |
|
Mémoire insuffisante. |
À titre d’exemple de nom convivial, une sous-unité avec une interface IAudioPeakMeter peut avoir le nom convivial « compteur de pointe ».
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | devicetopology.h |