IMDSPStorage::GetAttributes-Methode (mswmdm.h)

Artikel
03/04/2024

Die GetAttributes-Methode ruft die Attribute dieses Speicherobjekts ab.

Syntax

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

Parameter

[out] pdwAttributes

Zeiger auf ein DWORD , das die Attribute enthält, wie in der IWMDMMStorage::GetAttributes-Methode definiert.

[out] pFormat

Zeiger auf eine _WAVEFORMATEX Struktur, die mit Attributinformationen zum Objekt gefüllt ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Standard-COM-Fehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Die Auswertung von Attributen ist ein wichtiger Schritt beim Verfügbarmachen des Inhalts des Mediengeräts. Geräte unterstützen möglicherweise keine hierarchische Speicherung von Daten auf Speichermedien. Die GetAttributes-Methode ermöglicht es der Anwendung, die Unterstützung und das Format des Dateisystems abzuleiten, indem die Struktur mithilfe von Objektattributen ermittelt wird.

Beispielsweise geben die Attribute einer IMDSPStorage-Schnittstelle der obersten Ebene ein Speichermedium an, und IMDSPEnumStorage macht den Inhalt des Mediums verfügbar. Bei einer .mp3-Datei geben die Attribute eine Datei an, deren Typ durch weitere Überprüfung der Attribute und des Dateinamens bestimmt werden kann. In einem hierarchischen Medium können die Attribute ein Verzeichnis angeben, dessen Inhalt von IMDSPStorage::EnumStorage verfügbar gemacht werden kann.

Der parameter _WAVEFORMATEX ist optional. Wenn Sie einen gültigen _WAVEFORMATEX-Zeiger an eine Audiodatei übergeben, übergibt GetAttributes beschreibende Informationen zurück an die Struktur. Wenn die Datei jedoch kein Audio ist, wird der parameter _WAVEFORMATEX ignoriert.

Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.