Metodo IMDSPStorage::GetAttributes (mswmdm.h)

Articolo
02/29/2024

Il metodo GetAttributes recupera gli attributi di questo oggetto di archiviazione.

Sintassi

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

Parametri

[out] pdwAttributes

Puntatore a un DWORD contenente gli attributi definiti da nel metodo IWMDMStorage::GetAttributes .

[out] pFormat

Puntatore a una struttura _WAVEFORMATEX compilata con informazioni sugli attributi sull'oggetto.

Valore restituito

Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

La valutazione degli attributi è un passaggio fondamentale quando si espone il contenuto del dispositivo multimediale. I dispositivi potrebbero non supportare l'archiviazione gerarchica dei dati nei supporti di archiviazione. Il metodo GetAttributes consente all'applicazione di dedurre il supporto e il formato del file system individuandone la struttura tramite gli attributi dell'oggetto.

Ad esempio, gli attributi di un'interfaccia IMDSPStorage di primo livello indicano un supporto di archiviazione e IMDSPEnumStorage espone il contenuto del supporto. Per un file .mp3, gli attributi indicano un file il cui tipo può essere determinato esaminando ulteriormente sia gli attributi che il nome del file. In un supporto gerarchico, gli attributi possono indicare una directory il cui contenuto può essere esposto da IMDSPStorage::EnumStorage.

Il parametro _WAVEFORMATEX è facoltativo. Se passi un puntatore _WAVEFORMATEX valido a un file audio, GetAttributes passa di nuovo informazioni descrittive alla struttura. Tuttavia, se il file non è audio, il parametro _WAVEFORMATEX viene ignorato.

Questo metodo deve essere implementato. Non deve restituire WMDM_E_NOTSUPPORTED o E_NOTIMPL. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.