Méthode IKsJackDescription ::GetJackCount (devicetopology.h)
La méthode GetJackCount obtient le nombre de prises nécessaires pour se connecter à un périphérique de point de terminaison audio.
Syntaxe
HRESULT GetJackCount(
[out] UINT *pcJacks
);
Paramètres
[out] pcJacks
Pointeur vers une variable UINT dans laquelle la méthode écrit le nombre de prises associées au connecteur.
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Pointeur pcJacks a la valeur NULL. |
Remarques
Un appareil de point de terminaison audio qui lit ou enregistre un flux contenant plusieurs canaux peut nécessiter une connexion avec plusieurs prises (connecteur physique).
Par exemple, un ensemble de haut-parleurs surround qui lit un flux audio à 6 canaux peut nécessiter trois prises stéréo. Dans cet exemple, la première prise transmet les canaux pour les haut-parleurs avant gauche et avant droit, la deuxième prise transmet les canaux pour les haut-parleurs avant-centre et à basse fréquence (subwoofer), et la troisième prise transmet les canaux pour les haut-parleurs côté gauche et côté droit.
Après avoir appelé cette méthode pour récupérer le nombre de prises, appelez la méthode IKsJackDescription ::GetJackDescription une fois pour chaque prise afin d’obtenir une description de la prise.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | devicetopology.h |