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

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

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

Voir aussi

IMDSPDevice Interface

IMDSPEnumDevice Interface