MÉTHODE IMDSPStorage2 ::CreateStorage2 (mswmdm.h)

Article
08/25/2023

La méthode CreateStorage2 crée un stockage avec le nom spécifié et retourne un pointeur vers l’interface IMDSPStorage sur le stockage nouvellement créé.

Syntaxe

HRESULT CreateStorage2(
  [in]  DWORD            dwAttributes,
  [in]  DWORD            dwAttributesEx,
  [in]  _WAVEFORMATEX    *pAudioFormat,
  [in]  _VIDEOINFOHEADER *pVideoFormat,
  [in]  LPWSTR           pwszName,
  [in]  ULONGLONG        qwFileSize,
  [out] IMDSPStorage     **ppNewStorage
);

Paramètres

[in] dwAttributes

DWORD contenant les attributs comme décrit dans la méthode IMDSPStorage ::CreateStorage .

[in] dwAttributesEx

DWORD contenant les attributs étendus. Aucun attribut étendu n’est actuellement défini.

[in] pAudioFormat

Pointeur vers une structure de _WAVEFORMATEX qui contient des informations de format audio sur l’objet. Ce paramètre est facultatif et est ignoré si le fichier n’est pas audio.

[in] pVideoFormat

Pointeur vers une structure de _VIDEOINFOHEADER qui contient des informations de format vidéo sur l’objet. Ce paramètre est facultatif et est ignoré si le fichier n’est pas vidéo.

[in] pwszName

Pointeur vers une chaîne null à caractères larges contenant le nom du nouveau stockage.

[in] qwFileSize

QWORD contenant la taille du fichier à créer. Si la taille totale du fichier de sortie n’est pas connue au moment de la création, cette valeur est définie sur zéro.

[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 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

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 de dossier remplace l’attribut de fichier 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 être inséré dans le stockage actuel, à condition que le stockage actuel soit un dossier. Ceci est contrôlé par la valeur du paramètre dwAttributes . S’il spécifie WMDM_STORAGECONTROL_INSERTBEFORE ou WMDM_STORAGECONTROL_INSERTAFTER, le nouveau stockage sera créé au même niveau que le stockage actuel. S’il spécifie WMDM_STORAGECONTROL_INSERTINTO, le nouveau stockage sera 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.

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

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

IMDSPStorage2 Interface

IMDSPStorage ::CreateStorage

Partager via