Metodo IKsJackDescription::GetJackCount (devicetopology.h)

  • Articolo

Il metodo GetJackCount ottiene il numero di jack necessari per connettersi a un dispositivo endpoint audio.

Sintassi

HRESULT GetJackCount(
  [out] UINT *pcJacks
);

Parametri

[out] pcJacks

Puntatore a una variabile UINT in cui il metodo scrive il numero di jack associati al connettore.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito Descrizione
E_POINTER
 Pointer pcJacks è NULL.

Commenti

Un dispositivo endpoint audio che riproduce o registra un flusso che contiene più canali potrebbe richiedere una connessione con più jack (connettore fisico).

Ad esempio, un set di altoparlanti surround che riproduce un flusso audio a 6 canali potrebbe richiedere tre jack stereo. In questo esempio, il primo jack trasmette i canali per gli altoparlanti front-left e front-right, il secondo jack trasmette i canali per gli altoparlanti front-center e low-frequency-effects (sugli effetti a bassa frequenza) e il terzo jack trasmette i canali per gli altoparlanti lato sinistro e laterale destro.

Dopo aver chiamato questo metodo per recuperare il conteggio dei jack, chiamare il metodo IKsJackDescription::GetJackDescription una volta per ogni jack per ottenere una descrizione del jack.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IKsJackDescription

IKsJackDescription::GetJackDescription