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

Article
03/04/2024

La méthode Next retourne un pointeur vers les interfaces IMDSPStoragecelt suivantes.

Syntaxe

HRESULT Next(
  [in]  ULONG        celt,
  [out] IMDSPStorage **ppStorage,
  [out] ULONG        *pceltFetched
);

Paramètres

[in] celt

Nombre d’interfaces de stockage demandées.

[out] ppStorage

Tableau de pointeurs d’interface CELTIMDSPStorage alloués par l’appelant. Retourne la valeur NULL s’il n’existe plus de support de stockage ou si 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 retourné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 suivantes de codes d’erreur :

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 stockage ou qu’il y a moins d’interfaces de stockage que demandé, 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 retournées, le cas échéant.

L’énumérateur de stockage peut ne pas refléter l’effet de l’insertion et de la suppression du média. Dans ce cas, le client doit obtenir un nouvel objet énumérateur.

Cette méthode doit être implémentée. Il ne doit pas retourner WMDM_E_NOTSUPPORTED ni 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

IMDSPEnumStorage Interface

IMDSPStorage Interface

IWMDMStorage, interface

Partager via