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

El método GetIID obtiene el identificador de interfaz de la interfaz de control específica de la función de la parte.

Sintaxis

HRESULT GetIID(
  [out] GUID *pIID
);

Parámetros

[out] pIID

Puntero a una variable GUID en la que el método escribe el identificador de interfaz de la interfaz específica de la función de la parte. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Comentarios

Un objeto que representa una parte (conector o subunidad) tiene dos interfaces de control. La primera es una interfaz de control genérica, IControlInterface, que tiene métodos comunes a todos los tipos de controles. El segundo es una interfaz de control específica de función que tiene métodos que se aplican a un tipo determinado de control. El método GetIID obtiene el identificador de interfaz de la segunda interfaz de control. El cliente puede proporcionar este identificador de interfaz al método IPart::Activate para crear una instancia de la interfaz específica de la función del elemento.

El método obtiene uno de los identificadores de interfaz específicos de la función que se muestran en la tabla siguiente.

Para obtener el identificador de interfaz de una interfaz, use el operador __uuidof . Por ejemplo, el identificador de interfaz de la interfaz IAudioAutoGainControl se define de la siguiente manera:

const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Para obtener más información sobre el operador __uuidof, consulte la documentación de Windows SDK.

Requisitos

Consulte también

IControlInterface (Interfaz)