Метод IControlInterface::GetIID (devicetopology.h)
Метод GetIID получает идентификатор интерфейса элемента управления для конкретной функции.
Синтаксис
HRESULT GetIID(
[out] GUID *pIID
);
Параметры
[out] pIID
Указатель на переменную GUID, в которую метод записывает идентификатор интерфейса для конкретной функции интерфейса элемента управления. Дополнительные сведения см. в подразделе "Примечания".
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
PIID указателя имеет значение NULL. |
Комментарии
Объект, представляющий часть (соединитель или подсоединие), имеет два интерфейса управления. Первый — это универсальный интерфейс элемента управления IControlInterface, который содержит методы, общие для всех типов элементов управления. Второй — интерфейс элемента управления для конкретной функции, который содержит методы, применяемые к определенному типу элемента управления. Метод GetIID получает идентификатор второго интерфейса элемента управления. Клиент может предоставить этот идентификатор интерфейса методу IPart::Activate , чтобы создать экземпляр интерфейса для конкретной функции части.
Метод получает один из идентификаторов интерфейсов для конкретных функций, показанных в следующей таблице.
| Идентификатор интерфейса | Имя интерфейса |
|---|---|
| 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 |
Чтобы получить идентификатор интерфейса, используйте оператор __uuidof . Например, идентификатор интерфейса IAudioAutoGainControl определяется следующим образом:
const IID IID_IAudioAutoGainControl __uuidof(IAudioAutoGainControl)
Дополнительные сведения об операторе __uuidof см. в документации по Windows SDK.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | devicetopology.h |