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

Article
08/23/2023

La méthode Activate active une interface spécifique à une fonction sur un connecteur ou une sous-unité.

Syntaxe

HRESULT Activate(
  [in]  DWORD  dwClsContext,
  [in]  REFIID refiid,
  [out] void   **ppvObject
);

Paramètres

[in] dwClsContext

Contexte d’exécution dans lequel le code qui gère l’objet nouvellement créé s’exécutera. L’appelant peut restreindre le contexte en définissant ce paramètre sur le bit OR d’une ou de plusieurs valeurs d’énumération CLSCTX . Le client peut éviter d’imposer des restrictions de contexte en spécifiant CLSCTX_ALL. Pour plus d’informations sur CLSCTX, consultez la documentation du Kit de développement logiciel (SDK) Windows.

[in] refiid

ID d’interface pour la fonction de contrôle demandée. Le client doit définir ce paramètre sur l’une des valeurs REFIID suivantes :

IID_IAudioAutoGainControl

IID_IAudioBass

IID_IAudioChannelConfig

IID_IAudioInputSelector

IID_IAudioLoudness

IID_IAudioMidrange

IID_IAudioMute

IID_IAudioOutputSelector

IID_IAudioPeakMeter

IID_IAudioTreble

IID_IAudioVolumeLevel

IID_IDeviceSpecificProperty

IID_IKsFormatSupport

IID_IKsJackDescription

IID_IKsJackDescription2

Pour plus d'informations, consultez la section Notes.

[out] ppvObject

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse de l’interface spécifiée par le paramètre refiid. 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 Activer échoue, *ppObject 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_INVALIDARG	Le bit CLSCTX_INPROC_SERVER dans dwClsContext est égal à zéro.
E_POINTER	Le pointeur ppvObject a la valeur NULL.
E_NOINTERFACE	L’objet de composant ne prend pas en charge l’interface demandée.

Notes

La méthode Activate prend en charge les interfaces de contrôle spécifiques aux fonctions suivantes :

Pour obtenir l’ID d’interface de l’interface de contrôle spécifique à la fonction d’une partie, appelez la méthode IControlInterface::GetIID du composant. Pour obtenir l’ID d’interface d’un type d’interface de contrôle spécifique à une fonction, utilisez l’opérateur __uuidof . Par exemple, l’ID d’interface de IAudioAutoGainControl est défini comme suit :


const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Pour plus d’informations sur l’opérateur __uuidof , consultez la documentation du Kit de développement logiciel (SDK) Windows.

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::GetIID

IPart, interface

Partager via