MÉTHODE IMDSPEnumDevice ::Next (mswmdm.h)

Article
02/29/2024

La méthode Next récupère un pointeur vers les interfaces IMDSPDevicecelt suivantes.

Syntaxe

HRESULT Next(
  [in]  ULONG       celt,
  [out] IMDSPDevice **ppDevice,
  [out] ULONG       *pceltFetched
);

Paramètres

[in] celt

Nombre d’appareils demandés.

[out] ppDevice

Tableau de pointeurs celtIMDSPDevice alloués par l’appelant. Retourne la valeur NULL pour indiquer qu’il n’existe plus d’appareils ou qu’une erreur s’est produite. Si celt est supérieur à 1, l’appelant doit allouer suffisamment de mémoire pour stocker le nombre de pointeurs d’interface celt .

[out] pceltFetched

Pointeur vers une variable ULONG qui reçoit le nombre d’interfaces récupérées.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Lorsqu’il n’y a plus d’interfaces de fournisseur de services pour les appareils énumérés ou lorsqu’il y a moins d’interfaces que celles demandées par le paramètre celt , la valeur de retour de Next est S_FALSE. Dans ce cas, le paramètre pceltFetched doit être interrogé pour déterminer le nombre d’interfaces, le cas échéant, qui ont été retournées.

L’énumérateur d’appareil peut ne pas refléter l’effet de l’insertion et de la suppression de l’appareil.

Cette méthode doit être implémentée. Elle ne doit pas retourner WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

IMDSPDevice Interface

IMDSPEnumDevice Interface

Partager via