Метод IControlInterface::GetIID (devicetopology.h)

Статья
08/23/2023

Метод GetIID получает идентификатор интерфейса элемента управления для конкретной функции.

Синтаксис

HRESULT GetIID(
  [out] GUID *pIID
);

Параметры

[out] pIID

Указатель на переменную GUID, в которую метод записывает идентификатор интерфейса для конкретной функции интерфейса элемента управления. Дополнительные сведения см. в подразделе "Примечания".

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.

Код возврата	Описание
E_POINTER	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

См. также раздел

Интерфейс IControlInterface