Método IControlInterface::GetIID (devicetopology.h)

O método GetIID obtém a ID da interface de controle específica da função da parte.

Sintaxe

HRESULT GetIID(
  [out] GUID *pIID
);

Parâmetros

[out] pIID

Ponteiro para uma variável GUID na qual o método grava a ID de interface da interface de controle específica da função da parte. Para obter mais informações, consulte Comentários.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno	Descrição
E_POINTER	O pIID do ponteiro é NULL.

Comentários

Um objeto que representa uma parte (conector ou subunidade) tem duas interfaces de controle. A primeira é uma interface de controle genérica, IControlInterface, que tem métodos comuns a todos os tipos de controles. A segunda é uma interface de controle específica de função que tem métodos que se aplicam a um tipo específico de controle. O método GetIID obtém a ID da interface da segunda interface de controle. O cliente pode fornecer essa ID de interface para o método IPart::Activate para criar uma instância da interface específica da função da parte.

O método obtém uma das IDs de interface específicas da função mostradas na tabela a seguir.

ID da interface	Nome da 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

 

Para obter a ID da interface de uma interface, use o operador __uuidof . Por exemplo, a ID da interface IAudioAutoGainControl é definida da seguinte maneira:

const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Para obter mais informações sobre o operador __uuidof, consulte a documentação do SDK do Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	devicetopology.h

Confira também

IControlInterface Interface