MÉTHODE IMDSPStorage2 ::CreateStorage2 (mswmdm.h)
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
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 |