Metodo IKsJackDescription::GetJackDescription (devicetopology.h)
Il metodo GetJackDescription ottiene una descrizione di un jack audio.
Sintassi
HRESULT GetJackDescription(
[in] UINT nJack,
[out] KSJACK_DESCRIPTION *pDescription
);
Parametri
[in] nJack
Indice jack. Se la connessione è costituita da n jack, i jack vengono numerati da 0 a n- 1. Per ottenere il numero di jack, chiamare il metodo IKsJackDescription::GetJackCount .
[out] pDescription
Puntatore a un buffer allocato dal chiamante in cui il metodo scrive una struttura di tipo KSJACK_DESCRIPTION contenente informazioni sul jack. Le dimensioni del buffer devono essere almeno sizeof(KSJACK_DESCRIPTION).
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il parametro nJack non è un indice jack valido. |
|
Il puntatore pDescription è NULL. |
Commenti
Quando un utente deve collegare un dispositivo endpoint audio a un jack o scollegarlo da un jack, un'applicazione audio può usare le informazioni descrittive recuperate da questo metodo per aiutare l'utente a trovare il jack. Sono incluse le informazioni seguenti:
- Posizione fisica del jack sullo chassis del computer o della scatola esterna.
- Colore del jack.
- Tipo di connettore fisico usato per il jack.
- Mapping dei canali al 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