Método IMDSPStorage::CreateStorage (mswmdm.h)

  • Artículo

El método CreateStorage crea un nuevo almacenamiento y devuelve un puntero a la interfaz IMDSPStorage en el almacenamiento recién creado. Este método es opcional a menos que dwAttributes sea WMDM_FILE_ATTR_FILE. En ese caso, este método debe implementarse y no debe devolver WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Sintaxis

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

Parámetros

[in] dwAttributes

DWORD que contiene los atributos del nuevo almacenamiento. En la tabla siguiente se enumeran los atributos de almacenamiento disponibles.

Atributo Descripción
WMDM_STORAGECONTROL_INSERTBEFORE El nuevo objeto de almacenamiento se creará delante del objeto de destino.
WMDM_STORAGECONTROL_INSERTAFTER El nuevo objeto de almacenamiento se creará después del objeto de destino.
WMDM_STORAGECONTROL_INSERTINTO El nuevo objeto de almacenamiento se creará en la carpeta del objeto de destino.
WMDM_STORAGECONTROL_OVERWRITE Si el almacenamiento con el mismo nombre ya existe, se destruirá y se creará un nuevo almacenamiento.
WMDM_STORAGE_ATTR_FILESYSTEM Este objeto es el medio de almacenamiento de nivel superior (por ejemplo, una tarjeta de almacenamiento u otro almacenamiento a bordo).
WMDM_STORAGE_ATTR_REMOVABLE Este medio de almacenamiento es extraíble.
WMDM_STORAGE_ATTR_CANEDITMETADATA Este almacenamiento puede editar metadatos.
WMDM_STORAGE_ATTR_FOLDERS Este medio de almacenamiento admite carpetas y jerarquía de archivos.
WMDM_FILE_ATTR_FOLDER Se trata de una carpeta en el medio de almacenamiento.
WMDM_FILE_ATTR_LINK Se trata de un vínculo que crea una asociación entre varios archivos.
WMDM_FILE_ATTR_FILE Se trata de un archivo en el medio de almacenamiento.
WMDM_FILE_ATTR_AUDIO Este archivo es datos de audio.
WMDM_FILE_ATTR_DATA Este archivo no es de audio.
WMDM_FILE_ATTR_CANPLAY El dispositivo puede reproducir este archivo de audio.
WMDM_FILE_ATTR_CANDELETE Este archivo se puede eliminar.
WMDM_FILE_ATTR_CANMOVE Este archivo o carpeta se puede mover en el medio de almacenamiento.
WMDM_FILE_ATTR_CANRENAME Se puede cambiar el nombre de este archivo o carpeta.
WMDM_FILE_ATTR_CANREAD El equipo host puede leer este archivo.
WMDM_FILE_ATTR_MUSIC Este archivo de audio es música.
WMDM_FILE_ATTR_VIDEO Este archivo contiene datos de vídeo.
WMDM_FILE_ATTR_HIDDEN Este archivo está oculto en el sistema de archivos.
WMDM_FILE_ATTR_SYSTEM Se trata de un archivo del sistema
WMDM_FILE_ATTR_READONLY Se trata de un archivo de solo lectura.
WMDM_STORAGE_IS_DEFAULT Este almacenamiento es el almacenamiento predeterminado donde se deben colocar nuevos medios.
WMDM_STORAGE_CONTAINS_DEFAULT Este almacenamiento contiene el almacenamiento predeterminado donde se deben colocar nuevos medios.

[in] pFormat

Puntero a una estructura de _WAVEFORMATEX que contiene información sobre el objeto, si el objeto es un archivo de audio.

[in] pwszName

Puntero a una cadena terminada en null de caracteres anchos que contiene el nombre del nuevo almacenamiento.

[out] ppNewStorage

Puntero a un puntero IMDSPStorage para recibir la interfaz IMDSPStorage para el almacenamiento recién creado.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

  • Códigos de error COM estándar
  • Códigos de error de Windows convertidos en valores HRESULT
  • Códigos de error de windows Media Administrador de dispositivos
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Si se establecen los atributos WMDM_FILE_ATTR_FOLDER y WMDM_FILE_ATTR_FILE, el atributo folder invalida el atributo de archivo y el nuevo almacenamiento se crea como una carpeta.

Solo el cliente puede especificar uno de WMDM_STORAGECONTROL_INSERTBEFORE, WMDM_STORAGECONTROL_INSERTAFTER y WMDM_STORAGECONTROL_INSERTINTO.

El nuevo almacenamiento se puede crear en el mismo nivel o se puede insertar en el almacenamiento actual siempre que el almacenamiento actual sea una carpeta. Esto se controla mediante el valor del parámetro dwAttributes . Si especifica WMDM_STORAGECONTROL_INSERTBEFORE o WMDM_STORAGECONTROL_INSERTAFTER, el nuevo almacenamiento se creará en el mismo nivel que el almacenamiento actual. Si especifica WMDM_STORAGECONTROL_INSERTINTO, el nuevo almacenamiento se insertará en el almacenamiento actual.

WMDM_STORAGECONTROL_INSERTBEFORE y WMDM_STORAGECONTROL_INSERAFTER implican una ordenación del contenido en el sistema de archivos. Si el sistema de archivos no admite la ordenación (por ejemplo, FAT32), ambas marcas tienen el efecto idéntico de insertar el nuevo almacenamiento en el mismo nivel del almacenamiento actual. Si el almacenamiento actual representa la raíz del medio de almacenamiento y se especifica una de estas dos marcas, se produce un error en la operación.

WMDM_STORAGECONTROL_INSERTINTO solo es válido si el almacenamiento actual es una carpeta. Si el almacenamiento actual es un archivo y se especifica esta marca, se produce un error en la operación.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

Interfaz IMDSPStorage

IMDSPStorage2::CreateStorage2

_WAVEFORMATEX