Metodo IWMDMStorage3::SetEnumPreference (mswmdm.h)

Articolo
03/15/2023

Il metodo SetEnumPreference imposta la modalità di visualizzazione preferita per l'archiviazione.

Sintassi

HRESULT SetEnumPreference(
  [in, out] WMDM_STORAGE_ENUM_MODE *pMode,
  [in]      DWORD                  nViews,
  [in]      WMDMMetadataView       *pViews
);

Parametri

[in, out] pMode

Modalità desiderata dell'enumeratore di archiviazione. Per altri dettagli sulla modalità, vedere WMDM_STORAGE_ENUM_MODE. Se il valore di pMode è impostato su ENUM_MODE_USE_DEVICE_PREF, al momento della restituzione viene impostato su ENUM_MODE_RAW o ENUM_MODE_METADATA_VIEWS, in base alla preferenza del dispositivo.

[in] nViews

Numero di definizioni di visualizzazione fornite.

Questo parametro viene ignorato se il valore di pMode è ENUM_MODE_RAW o se il valore di pMode è ENUM_MODE_USE_DEVICE_PREF e il dispositivo non preferisce le visualizzazioni dei metadati.

Se il valore di pMode è ENUM_MODE_METADATA_VIEWS o se il valore di pMode è ENUM_MODE_USE_DEVICE_PREF e il dispositivo preferisce le visualizzazioni dei metadati, questo parametro può comunque essere 0. In questo caso, Windows Media Gestione dispositivi usa le visualizzazioni dei metadati predefinite.

Se il valore di nViews è 0, ppViews deve essere NULL. Se il valore di nViews non è 0, ppViews deve puntare a una matrice di strutture WMDMMetadataView con elementi nViews .

[in] pViews

Matrice di definizioni di visualizzazione. La lunghezza della matrice deve essere uguale a nViews.

Questo parametro viene ignorato se il valore di pMode è ENUM_MODE_RAW o se il valore di pMode è ENUM_MODE_USE_DEVICE_PREF e il dispositivo non preferisce le visualizzazioni dei metadati.

Se il valore di pMode è ENUM_MODE_METADATA_VIEWS o se il valore di pMode è ENUM_MODE_USE_DEVICE_PREF e il dispositivo preferisce le visualizzazioni dei metadati, questo parametro può comunque essere NULL. In questo caso Windows Media Gestione dispositivi usa le visualizzazioni dei metadati predefinite.

Il valore di questo parametro deve essere NULL se il valore di nViews è 0. Se il valore di nViews non è 0, ppViews deve puntare a una matrice di strutture WMDMMetadataView con elementi nViews .

Valore restituito

Il metodo restituisce un valore HRESULT. Nella tabella seguente sono elencati tutti i valori possibili.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente per allocare l'elemento.
E_INVALIDARG	Uno o più parametri non sono validi.
WMDM_E_NOT_CERTIFIED	Il chiamante non dispone dei diritti per eseguire questa operazione.
WMDM_E_NOTSUPPORTED	L'oggetto non supporta questo metodo.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Windows Media Gestione dispositivi può presentare visualizzazioni dei metadati del contenuto nel dispositivo. Illustra tutto il contenuto in una risorsa di archiviazione di primo livello ,ad esempio memoria interna o scheda di archiviazione, e restituisce un enumeratore di archiviazione che presenta il contenuto organizzato in base ai metadati del contenuto. La definizione di una visualizzazione metadati viene fornita tramite una struttura WMDMMetadataView .

Questo comportamento è controllato dal parametro pMode . Se pMode è impostato su ENUM_MODE_RAW, Windows Media Gestione dispositivi restituisce un enumeratore che rispecchia la gerarchia del file system nella risorsa di archiviazione del dispositivo. Se pMode è impostato su ENUM_MODE_METADATA_VIEWS, Windows Media Gestione dispositivi genera visualizzazioni di metadati.

I dispositivi indicano la preferenza impostando il parametro del dispositivo UseMetadataViews al momento dell'installazione del dispositivo. Per altre informazioni su UseMetadataViews, vedere Parametri del dispositivo. Se l'applicazione consentirà al dispositivo di decidere il tipo di enumeratore di archiviazione restituito, deve impostare pMode su ENUM_MODE_USE_DEVICE_PREF.

Dopo la chiamata a questo metodo, le chiamate successive a IWMDMStorage::EnumStorage si comportano in base alla preferenza di enumerazione di archiviazione impostata da questo metodo. Questo metodo può essere chiamato di nuovo per modificare il comportamento delle successive chiamate IWMDMStorage::EnumStorage .

Questo metodo deve in genere essere chiamato nella risorsa di archiviazione di primo livello. Se questo metodo viene chiamato in una delle risorse di archiviazione nella visualizzazione metadati, restituirà WMDM_E_NOTSUPPORTED.