Método IPart::GetControlInterface (devicetopology.h)

  • Artículo

El método GetControlInterface obtiene una referencia a la interfaz de control especificada, si esta parte la admite.

Sintaxis

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

Parámetros

[in] nIndex

Número de interfaz de control. Si una parte admite n interfaces de control, las interfaces de control se numeran de 0 a n– 1.

[out] ppInterfaceDesc

Puntero a una variable de puntero en la que el método escribe la dirección de la interfaz IControlInterface de la función de audio especificada. A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada a GetControlInterface , *ppFunction es NULL.

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 ppFunction es NULL.
E_INVALIDARG
 El parámetro nIndex está fuera del intervalo.
E_NOTFOUND
 La parte no tiene una interfaz de control.

Requisitos

   
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)

IPart (Interfaz)