MÉTHODE IMDSPStorage ::GetAttributes (mswmdm.h)

Article
03/04/2024

La méthode GetAttributes récupère les attributs de cet objet de stockage.

Syntaxe

HRESULT GetAttributes(
  [out] DWORD         *pdwAttributes,
  [out] _WAVEFORMATEX *pFormat
);

Paramètres

[out] pdwAttributes

Pointeur vers un DWORD contenant les attributs définis par dans la méthode IWMDMStorage ::GetAttributes .

[out] pFormat

Pointeur vers une structure _WAVEFORMATEX remplie d’informations d’attribut sur l’objet .

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

L’évaluation des attributs est une étape cruciale lors de l’exposition du contenu de l’appareil multimédia. Les appareils peuvent ne pas prendre en charge le stockage hiérarchique des données sur un support de stockage. La méthode GetAttributes permet à l’application de déduire la prise en charge et le format du système de fichiers en découvrant sa structure par le biais d’attributs d’objet.

Par exemple, les attributs d’une interface IMDSPStorage de niveau supérieur indiquent un support de stockage, et IMDSPEnumStorage expose le contenu du support. Pour un fichier .mp3, les attributs indiquent un fichier dont le type peut être déterminé par un examen approfondi des attributs et du nom de fichier. Dans un support hiérarchique, les attributs peuvent indiquer un répertoire dont le contenu peut être exposé par IMDSPStorage ::EnumStorage.

Le paramètre _WAVEFORMATEX est facultatif. Si vous transmettez un pointeur de _WAVEFORMATEX valide à un fichier audio, GetAttributes transmet les informations descriptives à la structure. Toutefois, si le fichier n’est pas audio, le paramètre _WAVEFORMATEX est ignoré.

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.