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

Article
03/06/2024

La méthode CreateStorage crée un stockage et retourne un pointeur vers l’interface IMDSPStorage sur le stockage nouvellement créé. Cette méthode est facultative, sauf si dwAttributes est WMDM_FILE_ATTR_FILE. Dans ce cas, cette méthode doit être implémentée et ne doit pas retourner WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Syntaxe

HRESULT CreateStorage(
  [in]  DWORD         dwAttributes,
  [in]  _WAVEFORMATEX *pFormat,
  [in]  LPWSTR        pwszName,
  [out] IMDSPStorage  **ppNewStorage
);

Paramètres

[in] dwAttributes

DWORD contenant les attributs du nouveau stockage. Le tableau suivant répertorie les attributs de stockage disponibles.

Attribut	Description
WMDM_STORAGECONTROL_INSERTBEFORE	Le nouvel objet de stockage est créé devant l’objet cible.
WMDM_STORAGECONTROL_INSERTAFTER	Le nouvel objet de stockage sera créé après l’objet cible.
WMDM_STORAGECONTROL_INSERTINTO	Le nouvel objet de stockage sera créé dans le dossier de l’objet cible.
WMDM_STORAGECONTROL_OVERWRITE	Si le stockage portant le même nom existe déjà, il est détruit et un nouveau stockage est créé.
WMDM_STORAGE_ATTR_FILESYSTEM	Cet objet est le support de stockage de niveau supérieur (par exemple, un carte de stockage ou un autre stockage intégré).)
WMDM_STORAGE_ATTR_REMOVABLE	Ce support de stockage est amovible.
WMDM_STORAGE_ATTR_CANEDITMETADATA	Ce stockage peut modifier les métadonnées.
WMDM_STORAGE_ATTR_FOLDERS	Ce support de stockage prend en charge les dossiers et la hiérarchie de fichiers.
WMDM_FILE_ATTR_FOLDER	Il s’agit d’un dossier sur le support de stockage.
WMDM_FILE_ATTR_LINK	Il s’agit d’un lien qui crée une association entre plusieurs fichiers.
WMDM_FILE_ATTR_FILE	Il s’agit d’un fichier sur le support de stockage.
WMDM_FILE_ATTR_AUDIO	Ce fichier est des données audio.
WMDM_FILE_ATTR_DATA	Ce fichier est des données non audio.
WMDM_FILE_ATTR_CANPLAY	Ce fichier audio peut être lu par l’appareil.
WMDM_FILE_ATTR_CANDELETE	Ce fichier peut être supprimé.
WMDM_FILE_ATTR_CANMOVE	Ce fichier ou dossier peut être déplacé sur le support de stockage.
WMDM_FILE_ATTR_CANRENAME	Ce fichier ou dossier peut être renommé.
WMDM_FILE_ATTR_CANREAD	Ce fichier peut être lu par l’ordinateur hôte.
WMDM_FILE_ATTR_MUSIC	Ce fichier audio est de la musique.
WMDM_FILE_ATTR_VIDEO	Ce fichier contient des données vidéo.
WMDM_FILE_ATTR_HIDDEN	Ce fichier est masqué sur le système de fichiers
WMDM_FILE_ATTR_SYSTEM	Il s’agit d’un fichier système
WMDM_FILE_ATTR_READONLY	Il s’agit d’un fichier en lecture seule.
WMDM_STORAGE_IS_DEFAULT	Ce stockage est le stockage par défaut dans lequel les nouveaux supports doivent être placés.
WMDM_STORAGE_CONTAINS_DEFAULT	Ce stockage contient le stockage par défaut dans lequel les nouveaux supports doivent être placés.

[in] pFormat

Pointeur vers une structure _WAVEFORMATEX qui contient des informations sur l’objet, si l’objet est un fichier audio.

[in] pwszName

Pointeur vers une chaîne de caractères larges terminée par un caractère Null contenant le nom du nouveau stockage.

[out] ppNewStorage

Pointeur vers un pointeur IMDSPStorage pour recevoir l’interface IMDSPStorage pour le stockage nouvellement créé.

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

Si les attributs WMDM_FILE_ATTR_FOLDER et WMDM_FILE_ATTR_FILE sont définis, l’attribut folder remplace l’attribut file et le nouveau stockage est créé en tant que dossier.

Un seul des WMDM_STORAGECONTROL_INSERTBEFORE, WMDM_STORAGECONTROL_INSERTAFTER et WMDM_STORAGECONTROL_INSERTINTO peut être spécifié par le client.

Le nouveau stockage peut être créé au même niveau ou inséré dans le stockage actuel, à condition que le stockage actuel soit un dossier. Cela est contrôlé par la valeur du paramètre dwAttributes . S’il spécifie WMDM_STORAGECONTROL_INSERTBEFORE ou WMDM_STORAGECONTROL_INSERTAFTER, le nouveau stockage est créé au même niveau que le stockage actuel. S’il spécifie WMDM_STORAGECONTROL_INSERTINTO, le nouveau stockage est inséré dans le stockage actuel.

WMDM_STORAGECONTROL_INSERTBEFORE et WMDM_STORAGECONTROL_INSERAFTER impliquent un classement du contenu dans le système de fichiers. Si le système de fichiers ne prend pas en charge l’ordre (par exemple, FAT32), les deux indicateurs ont le même effet d’insérer le nouveau stockage au même niveau que le stockage actuel. Si le stockage actuel représente la racine du support de stockage et qu’un de ces deux indicateurs est spécifié, l’opération échoue.

WMDM_STORAGECONTROL_INSERTINTO est valide uniquement si le stockage actuel est un dossier. Si le stockage actuel est un fichier et que cet indicateur est spécifié, l’opération échoue.