Поделиться через


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

Метод 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