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 |
|---|---|
|
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 |