Método IMDServiceProvider3::SetDeviceEnumPreference (mswmdm.h)
El método SetDeviceEnumPreference establece las preferencias de enumeración de dispositivos.
Sintaxis
HRESULT SetDeviceEnumPreference(
[in] DWORD dwEnumPref
);
Parámetros
[in] dwEnumPref
Contiene una combinación OR bit a bit de uno o varios de los siguientes valores de bits que especifican la preferencia de enumeración. Cada bit establecido habilita el comportamiento extendido correspondiente, mientras que la ausencia de ese bit deshabilita el comportamiento extendido y especifica el comportamiento de enumeración predeterminado compatible con versiones anteriores. Los valores posibles para dwEnumPref se proporcionan en la tabla siguiente.
| Valor | Descripción |
|---|---|
| DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES | De forma predeterminada, para los dispositivos que contienen varios medios de almacenamiento, cada uno de estos almacenamientos enumera como un pseudodispositivo independiente. Sin embargo, cuando se establece este bit, los almacenamientos no son visibles como dispositivos y solo los dispositivos son visibles como dispositivos. |
| ALLOW_OUTOFBAND_NOTIFICATION | De forma predeterminada, el mecanismo de devolución de llamada IWMDMNotification proporciona a las aplicaciones eventos de llegada y eliminación de dispositivos. Cuando se establece este bit, el proveedor de servicios es libre de notificar a la aplicación por un mecanismo independiente, como mediante un mensaje de ventana. Este comportamiento se suma a las notificaciones de Administrador de dispositivos de Windows Media. Esta marca no suprime las notificaciones de Windows Media Administrador de dispositivos. |
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
El parámetro dwEnumPref contiene un valor de bit no admitido. |
|
Se llamó al método después de una operación de enumeración. Se debe llamar a antes de la operación de enumeración. |
Comentarios
Esta API proporciona a los clientes la capacidad de invalidar el comportamiento predeterminado de enumeración de dispositivos de Windows Media Administrador de dispositivos.
Las aplicaciones cliente deben llamar a este método inmediatamente después de crear el objeto de administrador de dispositivos consultando la interfaz IWMDeviceManager desde Windows Media Administrador de dispositivos. La llamada debe realizarse antes de que se produzca cualquier enumeración, ya sea explícita o implícitamente como resultado de otra operación.
Después de establecer una marca de preferencia, no se puede cambiar durante la vigencia de la aplicación (no solo la duración del objeto Administrador de dispositivos de Windows Media). Si se intenta cambiar una marca de preferencia, se producirá un error. Llamar a esta API de nuevo con la misma configuración de marca no devuelve un error y también tiene ningún efecto en la enumeración.
El proveedor de servicios debe respetar la marca DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES para que surta efecto. Es posible que, a pesar de esta marca, algunos dispositivos se enumeran como un dispositivo por almacenamiento.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | mswmdm.h |
| Library | Mssachlp.lib |