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