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

Artículo
02/29/2024

El método GetAttributes recupera los atributos de este objeto de almacenamiento.

Sintaxis

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

Parámetros

[out] pdwAttributes

Puntero a un DWORD que contiene los atributos definidos por en el método IWMDMStorage::GetAttributes .

[out] pFormat

Puntero a una estructura de _WAVEFORMATEX que se rellena con información de atributo sobre el objeto.

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

La evaluación de atributos es un paso fundamental al exponer el contenido del dispositivo multimedia. Es posible que los dispositivos no admitan el almacenamiento jerárquico de datos en los medios de almacenamiento. El método GetAttributes permite a la aplicación deducir la compatibilidad y el formato del sistema de archivos mediante la detección de su estructura a través de atributos de objeto.

Por ejemplo, los atributos de una interfaz IMDSPStorage de nivel superior indican un medio de almacenamiento y IMDSPEnumStorage expone el contenido del medio. Para un archivo .mp3, los atributos indican un archivo cuyo tipo se puede determinar mediante un examen posterior de los atributos y el nombre de archivo. En un medio jerárquico, los atributos pueden indicar un directorio cuyo contenido puede exponer IMDSPStorage::EnumStorage.

El parámetro _WAVEFORMATEX es opcional. Si pasa un puntero _WAVEFORMATEX válido a un archivo de audio, GetAttributes pasa información descriptiva a la estructura. Sin embargo, si el archivo no es audio, se omite el parámetro _WAVEFORMATEX .

Este método debe implementarse. No debe devolver WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Para obtener más información, consulte Interfaces obligatorias y opcionales.