Partager via


Méthode IKsJackDescription2 ::GetJackDescription2 (devicetopology.h)

La méthode GetJackDescription2 obtient la description d’une prise audio spécifiée.

Syntaxe

HRESULT GetJackDescription2(
  [in]  UINT                nJack,
  [out] KSJACK_DESCRIPTION2 *pDescription2
);

Paramètres

[in] nJack

Index de la prise jack pour laquelle obtenir une description. Si la connexion se compose de n jacks, les prises sont numérotées de 0 à n– 1. Pour obtenir le nombre de prises, appelez la méthode IKsJackDescription ::GetJackCount .

[out] pDescription2

Pointeur vers une mémoire tampon allouée par l’appelant dans laquelle la méthode écrit une structure de type KSJACK_DESCRIPTION2 qui contient des informations sur la prise jack. La taille de la mémoire tampon doit être au moins sizeof(KSJACK_DESCRIPTION2).

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
E_INVALIDARG
Le paramètre nJack n’est pas un index jack valide.
E_POINTER
Le pointeur pDescription a la valeur NULL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête devicetopology.h

Voir aussi

IKsJackDescription2