Méthode IControlInterface ::GetIID (devicetopology.h)
La méthode GetIID obtient l’ID d’interface de l’interface de contrôle spécifique à la fonction de la partie.
Syntaxe
HRESULT GetIID(
[out] GUID *pIID
);
Paramètres
[out] pIID
Pointeur vers une variable GUID dans laquelle la méthode écrit l’ID d’interface de l’interface de contrôle spécifique à la fonction de la partie. Pour plus d'informations, consultez la section Notes.
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 pIID du pointeur a la valeur NULL. |
Remarques
Un objet qui représente une partie (connecteur ou sous-unité) a deux interfaces de contrôle. La première est une interface de contrôle générique, IControlInterface, qui a des méthodes communes à tous les types de contrôles. La deuxième est une interface de contrôle spécifique à une fonction qui a des méthodes qui s’appliquent à un type particulier de contrôle. La méthode GetIID obtient l’ID d’interface de la deuxième interface de contrôle. Le client peut fournir cet ID d’interface à la méthode IPart ::Activate pour créer un instance de l’interface spécifique à la fonction du composant.
La méthode obtient l’un des ID d’interface spécifiques à la fonction indiqués dans le tableau suivant.
| ID d’interface | Nom de l’interface |
|---|---|
| IID_IAudioAutoGainControl | IAudioAutoGainControl |
| IID_IAudioBass | IAudioBass |
| IID_IAudioChannelConfig | IAudioChannelConfig |
| IID_IAudioInputSelector | IAudioInputSelector |
| IID_IAudioLoudness | IAudioLoudness |
| IID_IAudioMidrange | IAudioMidrange |
| IID_IAudioMute | IAudioMute |
| IID_IAudioOutputSelector | IAudioOutputSelector |
| IID_IAudioPeakMeter | IAudioPeakMeter |
| IID_IAudioTreble | IAudioTreble |
| IID_IAudioVolumeLevel | IAudioVolumeLevel |
| IID_IDeviceSpecificProperty | IDeviceSpecificProperty |
| IID_IKsFormatSupport | IKsFormatSupport |
| IID_IKsJackDescription | IKsJackDescription |
Pour obtenir l’ID d’interface d’une interface, utilisez l’opérateur __uuidof . Par exemple, l’ID d’interface de l’interface IAudioAutoGainControl est défini comme suit :
const IID IID_IAudioAutoGainControl __uuidof(IAudioAutoGainControl)
Pour plus d’informations sur l’opérateur __uuidof, consultez la documentation SDK Windows.
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 |