Méthode IWMDMStorage3 ::SetEnumPreference (mswmdm.h)

Article
08/25/2023

La méthode SetEnumPreference définit le mode d’affichage préféré pour le stockage.

Syntaxe

HRESULT SetEnumPreference(
  [in, out] WMDM_STORAGE_ENUM_MODE *pMode,
  [in]      DWORD                  nViews,
  [in]      WMDMMetadataView       *pViews
);

Paramètres

[in, out] pMode

Mode souhaité de l’énumérateur de stockage. Pour plus d’informations sur le mode, consultez WMDM_STORAGE_ENUM_MODE. Si la valeur de pMode est définie sur ENUM_MODE_USE_DEVICE_PREF, elle est définie sur ENUM_MODE_RAW ou ENUM_MODE_METADATA_VIEWS, en fonction de la préférence de l’appareil.

[in] nViews

Nombre de définitions d’affichage fournies.

Ce paramètre est ignoré si la valeur de pMode est ENUM_MODE_RAW ou si la valeur de pMode est ENUM_MODE_USE_DEVICE_PREF et que l’appareil ne préfère pas les vues de métadonnées.

Si la valeur de pMode est ENUM_MODE_METADATA_VIEWS ou si la valeur de pMode est ENUM_MODE_USE_DEVICE_PREF et que l’appareil préfère les vues de métadonnées, ce paramètre peut toujours être égal à 0. Dans ce cas, Windows Media Gestionnaire de périphériques utilise ses vues de métadonnées par défaut.

Si la valeur de nViews est 0, ppViews doit être NULL. Si la valeur de nViews n’est pas 0, les ppViews doivent pointer vers un tableau de structures WMDMMetadataView avec des éléments nViews .

[in] pViews

Tableau de définitions de vue. La longueur du tableau doit être égale à nViews.

Ce paramètre est ignoré si la valeur de pMode est ENUM_MODE_RAW ou si la valeur de pMode est ENUM_MODE_USE_DEVICE_PREF et que l’appareil ne préfère pas les vues de métadonnées.

Si la valeur de pMode est ENUM_MODE_METADATA_VIEWS ou si la valeur de pMode est ENUM_MODE_USE_DEVICE_PREF et que l’appareil préfère les vues de métadonnées, ce paramètre peut toujours être NULL. Dans ce cas, Windows Media Gestionnaire de périphériques utilise ses vues de métadonnées par défaut.

La valeur de ce paramètre doit être NULL si la valeur de nViews est 0. Si la valeur de nViews n’est pas 0, les ppViews doivent pointer vers un tableau de structures WMDMMetadataView avec des éléments nViews .

Valeur retournée

Cette méthode retourne un code HRESULT. Le tableau suivant répertorie toutes les valeurs possibles.

Code de retour	Description
S_OK	S_OK
E_OUTOFMEMORY	La mémoire est insuffisante pour allouer l’élément.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
WMDM_E_NOT_CERTIFIED	L’appelant ne dispose pas des droits nécessaires pour exécuter cette opération.
WMDM_E_NOTSUPPORTED	L’objet ne prend pas en charge cette méthode.
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Les Gestionnaire de périphériques Windows Media peuvent présenter des vues de métadonnées du contenu sur l’appareil. Il décrit tout le contenu sur un stockage de niveau supérieur (par exemple, la mémoire interne ou un carte de stockage) et retourne un énumérateur de stockage qui présente le contenu organisé par métadonnées du contenu. La définition d’une vue de métadonnées est fournie via une structure WMDMMetadataView .

Ce comportement est contrôlé par le paramètre pMode . Si le pMode est défini sur ENUM_MODE_RAW, Windows Media Gestionnaire de périphériques retourne un énumérateur qui reflète la hiérarchie du système de fichiers sur le stockage de l’appareil. Si pMode est défini sur ENUM_MODE_METADATA_VIEWS, Windows Media Gestionnaire de périphériques génère des vues de métadonnées.

Les appareils indiquent leur préférence en définissant le paramètre d’appareil UseMetadataViews au moment de l’installation de l’appareil. Pour plus d’informations sur UseMetadataViews, consultez Paramètres d’appareil. Si l’application laisse l’appareil décider du type d’énumérateur de stockage retourné, elle doit définir pMode sur ENUM_MODE_USE_DEVICE_PREF.

Une fois cette méthode appelée, les appels ultérieurs à IWMDMStorage ::EnumStorage se comportent en fonction de la préférence d’énumération de stockage définie par cette méthode. Cette méthode peut être appelée à nouveau pour modifier le comportement des appels IWMDMStorage ::EnumStorage suivants.

Cette méthode doit généralement être appelée sur le stockage de niveau supérieur. Si cette méthode est appelée sur l’un des stockages dans la vue de métadonnées, elle retourne WMDM_E_NOTSUPPORTED.