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

Artigo
03/05/2024

O método GetAttributes recupera os atributos desse objeto de armazenamento.

Sintaxe

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

Parâmetros

[out] pdwAttributes

Ponteiro para um DWORD que contém os atributos conforme definido por no método IWMDMStorage::GetAttributes .

[out] pFormat

Ponteiro para uma estrutura de _WAVEFORMATEX preenchida com informações de atributo sobre o objeto.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

Códigos de erro COM padrão
Códigos de erro do Windows convertidos em valores HRESULT
Códigos de erro do Windows Media Gerenciador de Dispositivos

Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

A avaliação de atributos é uma etapa crucial ao expor o conteúdo do dispositivo de mídia. Os dispositivos podem não dar suporte ao armazenamento hierárquico de dados na mídia de armazenamento. O método GetAttributes permite que o aplicativo infera o suporte e o formato do sistema de arquivos descobrindo sua estrutura por meio de atributos de objeto.

Por exemplo, os atributos de uma interface IMDSPStorage de nível superior indicam um meio de armazenamento e IMDSPEnumStorage expõe o conteúdo do meio. Para um arquivo .mp3, os atributos indicam um arquivo cujo tipo pode ser determinado por um exame mais aprofundado dos atributos e do nome do arquivo. Em um meio hierárquico, os atributos podem indicar um diretório cujo conteúdo pode ser exposto por IMDSPStorage::EnumStorage.

O parâmetro _WAVEFORMATEX é opcional. Se você passar um ponteiro de _WAVEFORMATEX válido para um arquivo de áudio, GetAttributes passará informações descritivas de volta para a estrutura . No entanto, se o arquivo não for áudio, o parâmetro _WAVEFORMATEX será ignorado.

Esse método deve ser implementado. Ele não deve retornar WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.