Méthode IPart::GetControlInterface (devicetopology.h)

Article
08/23/2023

La méthode GetControlInterface obtient une référence à l’interface de contrôle spécifiée, si cette partie la prend en charge.

Syntaxe

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

Paramètres

[in] nIndex

Numéro de l’interface de contrôle. Si une partie prend en charge n interfaces de contrôle, les interfaces de contrôle sont numérotées de 0 à n– 1.

[out] ppInterfaceDesc

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse de l’interface IControlInterface de la fonction audio spécifiée. Grâce à cette méthode, l’appelant obtient une référence comptabilisée à l’interface. L’appelant est chargé de libérer l’interface, quand elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel GetControlInterface échoue, *ppFunction a la valeur 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_POINTER	Le pointeur ppFunction a la valeur NULL.
E_INVALIDARG	Le paramètre nIndex est hors limites.
E_NOTFOUND	Le composant n’a pas d’interface de contrôle.

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

Voir aussi

IControlInterface, interface

IPart, interface

Partager via