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.

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

Voir aussi

IMMDevice Interface

IMMDeviceCollection Interface

IMMDeviceCollection ::GetCount