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

Artigo
03/05/2024

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.