Méthode IAudioInputSelector ::SetSelection (devicetopology.h)
La méthode SetSelection sélectionne l’une des entrées du sélecteur d’entrée.
Syntaxe
HRESULT SetSelection(
[in] UINT nIdSelect,
[in] LPCGUID pguidEventContext
);
Paramètres
[in] nIdSelect
Nouvelle entrée de 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 entrées 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 d’entrée, tous les clients qui ont des interfaces IControlChangeNotify inscrites 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éterminer s’il est ou un autre client 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’une pièce au niveau d’une entrée de sélecteur. |
|
Mémoire insuffisante. |
Remarques
Un ID local est un nombre qui identifie de manière 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 part.
Pour obtenir un exemple de code qui appelle la méthode SetSelection , consultez l’implémentation de la fonction SelectCaptureDevice dans Topologies d’appareil.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |