Partager via

Méthode IAudioInputSelector ::SetSelection (devicetopology.h)

  • Article

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
E_INVALIDARG
 Le paramètre nIdSelect n’est pas l’ID local d’une pièce au niveau d’une entrée de sélecteur.
E_OUTOFMEMORY
 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

Voir aussi

IAudioInputSelector, interface

IPart ::GetLocalId