Metodo IMDServiceProvider3::SetDeviceEnumPreference (mswmdm.h)
Il metodo SetDeviceEnumPreference imposta le preferenze di enumerazione del dispositivo.
Sintassi
HRESULT SetDeviceEnumPreference(
[in] DWORD dwEnumPref
);
Parametri
[in] dwEnumPref
Contiene una combinazione OR bit per bit di uno o più dei valori di bit seguenti che specificano la preferenza di enumerazione. Ogni bit del set abilita il comportamento esteso corrispondente, mentre l'assenza di tale bit disabilita il comportamento esteso e specifica il comportamento di enumerazione predefinito compatibile con le versioni precedenti. I valori possibili per dwEnumPref sono disponibili nella tabella seguente.
| Valore | Descrizione |
|---|---|
| DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES | Per impostazione predefinita, per i dispositivi contenenti più supporti di archiviazione, ognuna di queste risorse di archiviazione enumera come pseudo-dispositivo separato. Tuttavia, quando questo bit è impostato, le risorse di archiviazione non sono visibili come dispositivi e solo i dispositivi sono visibili come dispositivi. |
| ALLOW_OUTOFBAND_NOTIFICATION | Per impostazione predefinita, il meccanismo di callback IWMDMNotification fornisce alle applicazioni eventi di arrivo e rimozione dei dispositivi. Quando questo bit è impostato, il provider di servizi è libero di inviare una notifica all'applicazione tramite un meccanismo separato, ad esempio tramite un messaggio di finestra. Questo comportamento si aggiunge alle notifiche di windows Media Gestione dispositivi. Questo flag non elimina le notifiche di Windows Media Gestione dispositivi. |
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro dwEnumPref contiene un valore di bit non supportato. |
|
Il metodo è stato chiamato dopo un'operazione di enumerazione. Deve essere chiamato prima dell'operazione di enumerazione. |
Commenti
Questa API consente ai client di eseguire l'override del comportamento di enumerazione del dispositivo predefinito di Windows Media Gestione dispositivi.
Le applicazioni client devono chiamare questo metodo immediatamente dopo aver creato l'oggetto gestione dispositivi eseguendo una query per l'interfaccia IWMDeviceManager da Windows Media Gestione dispositivi. La chiamata deve essere eseguita prima che si verifichi un'enumerazione, in modo esplicito o implicito in seguito a un'altra operazione.
Dopo aver impostato un flag di preferenza, non può essere modificato per la durata dell'applicazione (non solo per la durata dell'oggetto windows Media Gestione dispositivi). Il tentativo di modificare un flag di preferenza genererà un errore. La chiamata di nuovo a questa API con le stesse impostazioni di flag non restituisce un errore e ha anche alcun effetto sull'enumerazione.
Il flag DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES deve essere rispettato dal provider di servizi per rendere effettivo. È possibile che, nonostante questo flag, alcuni dispositivi vengano enumerati come dispositivo per ogni risorsa di archiviazione.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |