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