Méthode IAudioOutputSelector::SetSelection (devicetopology.h)
La méthode SetSelection sélectionne l’une des sorties du sélecteur de sortie.
Syntaxe
HRESULT SetSelection(
[in] UINT nIdSelect,
[in] LPCGUID pguidEventContext
);
Paramètres
[in] nIdSelect
Sortie du nouveau sélecteur. L’appelant doit définir ce paramètre sur l’ID local d’un composant qui a un lien direct vers l’une des sorties du sélecteur.
[in] pguidEventContext
Valeur de contexte pour la méthode IControlChangeNotify::OnNotify . Ce paramètre pointe vers un GUID de contexte d’événement. Si l’appel SetSelection modifie l’état du contrôle de sélecteur de sortie, tous les clients qui ont inscrit des interfaces IControlChangeNotify avec ce contrôle reçoivent des notifications. Dans son implémentation de la méthode OnNotify , un client peut inspecter le GUID de contexte d’événement pour découvrir s’il ou un autre client est la source de l’événement control-change. Si l’appelant fournit un pointeur NULL pour ce paramètre, la méthode de notification du client reçoit un pointeur de contexte NULL .
Valeur retournée
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 paramètre nIdSelect n’est pas l’ID local d’un composant à la sortie d’un sélecteur. |
|
Mémoire insuffisante. |
Notes
Un ID local est un nombre qui identifie de façon unique une partie parmi toutes les parties d’une topologie d’appareil. Pour obtenir l’ID local d’un composant, appelez la méthode IPart::GetLocalId sur l’objet de composant.
Spécifications
| 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 |