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

O método GetJackCount obtém o número de tomadas necessárias para se conectar a um dispositivo de ponto de extremidade de áudio.

Sintaxe

HRESULT GetJackCount(
  [out] UINT *pcJacks
);

Parâmetros

[out] pcJacks

Ponteiro para uma variável UINT na qual o método grava o número de tomadas associadas ao conector.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno	Descrição
E_POINTER	O ponteiro pcJacks é NULL.

Comentários

Um dispositivo de ponto de extremidade de áudio que reproduz ou grava um fluxo que contém vários canais pode exigir uma conexão com mais de uma tomada (conector físico).

Por exemplo, um conjunto de alto-falantes surround que reproduz um fluxo de áudio de 6 canais pode exigir três tomadas estéreo. Neste exemplo, o primeiro jack transmite os canais para os alto-falantes front-left e front-right, o segundo jack transmite os canais para os alto-falantes front-center e low-frequency-effects (subwoofer) e o terceiro jack transmite os canais para os alto-falantes laterais esquerdo e lateral-direito.

Depois de chamar esse método para recuperar a contagem de tomadas, chame o método IKsJackDescription::GetJackDescription uma vez para cada tomada obter uma descrição do jack.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	devicetopology.h

Confira também

IKsJackDescription Interface

IKsJackDescription::GetJackDescription