Método IKsJackDescription::GetJackCount (devicetopology.h)

  • Artículo

El método GetJackCount obtiene el número de conectores necesarios para conectarse a un dispositivo de punto de conexión de audio.

Sintaxis

HRESULT GetJackCount(
  [out] UINT *pcJacks
);

Parámetros

[out] pcJacks

Puntero a una variable UINT en la que el método escribe el número de conectores asociados al conector.

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 pcJacks es NULL.

Comentarios

Un dispositivo de punto de conexión de audio que reproduce o graba una secuencia que contiene varios canales puede requerir una conexión con más de un conector (conector físico).

Por ejemplo, un conjunto de altavoces envolventes que reproduce una secuencia de audio de 6 canales podría requerir tres tomas estéreo. En este ejemplo, el primer conector transmite los canales para los altavoces frontales izquierdo y frontal derecho, el segundo conector transmite los canales para los altavoces de efectos frontales y de baja frecuencia (subwoofer), y el tercer conector transmite los canales para los altavoces lateral izquierdo y lateral derecho.

Después de llamar a este método para recuperar el recuento de jacks, llame al método IKsJackDescription::GetJackDescription una vez para cada jack para obtener una descripción del jack.

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

IKsJackDescription (Interfaz)

IKsJackDescription::GetJackDescription