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 |
|---|---|
|
Le paramètre ppDevice a la valeur NULL. |
|
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 |