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.

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.

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

Confira também

IControlInterface Interface