Compartir a través de

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

  • Artículo

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.

Código devuelto Descripción
E_POINTER
 El puntero pIID es NULL.

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.

Id. de interfaz Nombre de la interfaz
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 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

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado devicetopology.h

Consulte también

IControlInterface (Interfaz)