Compartilhar via

Método IWMDMStorage4::SetReferences (mswmdm.h)

  • Artigo

O método SetReferences define as referências contidas em um armazenamento que tem referências (como uma playlist ou álbum), substituindo quaisquer referências existentes anteriormente mantidas pelo armazenamento.

Sintaxe

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IWMDMStorage **ppIWMDMStorage
);

Parâmetros

[in] dwRefs

Contagem de ponteiros de interface IWMDMStorage em ppIWMDMStorage. Zero é um valor aceitável e limpa todas as referências do armazenamento. O armazenamento em si não é excluído nesse caso.

[in] ppIWMDMStorage

Ponteiro para uma matriz de ponteiros de interface IWMDMStorage a serem referenciados pelo armazenamento. Essa ordem é preservada pelo armazenamento. NULL será um valor aceitável se dwRefs também for zero. O chamador é responsável por alocar e liberar essa matriz.

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

Esse método é usado para definir referências em objetos compostos por referências, como playlists ou álbuns. Se um dispositivo não der suporte a metadados, esse método provavelmente não terá suporte.

Qualquer objeto IWMDMStorage válido pode estar contido na matriz ppIWMDMStorage . Isso inclui pastas e outros armazenamentos que especificam as próprias referências (criando, por exemplo, uma playlist de playlists). O próprio dispositivo determina como qualquer caso específico de objeto referenciante é tratado. O Windows Media Gerenciador de Dispositivos não impõe nenhuma regra além da validade do IWMDMStorage. Considere o caso de uma playlist que contém referências de playlist aninhadas. Em um dispositivo, isso não é permitido e SetReferences falha. Em outro dispositivo, isso é permitido; A reprodução simplesmente atravessa todo o conjunto de referências contidas em ordem de profundidade-primeiro.

A situação pode surgir em que um ponteiro de interface IWMDMStorage4 corresponde a um armazenamento que não existe mais no dispositivo. WMDM_E_INTERFACEDEAD é retornado nesse caso.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

Criando uma playlist no dispositivo

IWMDMStorage4 Interface

IWMDMStorage4::GetReferences