Метод IMDSPStorage::GetAttributes (mswmdm.h)

Статья
08/25/2023

Метод GetAttributes извлекает атрибуты этого объекта хранилища.

Синтаксис

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

Параметры

[out] pdwAttributes

Указатель на DWORD , содержащий атрибуты, определенные в методе IWMDMStorage::GetAttributes .

[out] pFormat

Указатель на структуру _WAVEFORMATEX , заполненную сведениями об атрибутах объекта .

Возвращаемое значение

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

Стандартные коды ошибок COM
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств Windows Media

Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Оценка атрибутов является важным шагом при предоставлении содержимого устройства мультимедиа. Устройства могут не поддерживать иерархическое хранение данных на носителе. Метод GetAttributes позволяет приложению определить поддержку и формат файловой системы, обнаруживая ее структуру с помощью атрибутов объекта.

Например, атрибуты интерфейса IMDSPStorage верхнего уровня указывают на среду хранения, а IMDSPEnumStorage предоставляет содержимое среды. Для файла .mp3 атрибуты указывают файл, тип которого можно определить путем дальнейшего изучения атрибутов и имени файла. В иерархической среде атрибуты могут указывать каталог, содержимое которого может быть предоставлено IMDSPStorage::EnumStorage.

Параметр _WAVEFORMATEX является необязательным. При передаче допустимого указателя _WAVEFORMATEX на звуковой файл GetAttributes передает описательные сведения обратно в структуру. Однако если файл не является звуковым, параметр _WAVEFORMATEX игнорируется.

Этот метод должен быть реализован. Он не должен возвращать WMDM_E_NOTSUPPORTED или E_NOTIMPL. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.