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.

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)