IMMDeviceCollection ::Item, méthode (mmdeviceapi.h)

La méthode Item récupère un pointeur vers l’élément spécifié dans la collection d’appareils.

Syntaxe

HRESULT Item(
  [in]  UINT      nDevice,
  [out] IMMDevice **ppDevice
);

Paramètres

[in] nDevice

Numéro d’appareil. Si la collection contient n appareils, les appareils sont numérotés de 0 à n– 1.

[out] ppDevice

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse de l’interface IMMDevice de l’élément spécifié dans la collection d’appareils. Grâce à cette méthode, l’appelant obtient une référence comptée à l’interface. L’appelant est chargé de libérer l’interface, lorsqu’elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel d’élément échoue, *ppDevice a la valeur NULL.

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_POINTER
Le paramètre ppDevice a la valeur NULL.
E_INVALIDARG
Le paramètre nDevice n’est pas un numéro d’appareil valide.

Remarques

Cette méthode récupère un pointeur vers l’interface IMMDevice de l’élément spécifié dans la collection d’appareils. Chaque élément de la collection est un objet de point de terminaison qui représente un appareil de point de terminaison audio. L’appelant sélectionne un appareil dans la collection d’appareils en spécifiant le numéro d’appareil. Pour une collection de n appareils, les numéros d’appareil valides vont de 0 à n– 1. Pour obtenir le nombre d’appareils d’une collection, appelez la méthode IMMDeviceCollection ::GetCount .

Pour obtenir un exemple de code qui appelle la méthode Item , consultez Propriétés de l’appareil.

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 mmdeviceapi.h

Voir aussi

IMMDevice Interface

IMMDeviceCollection Interface

IMMDeviceCollection ::GetCount