Función SwDevicePropertySet (swdevice.h)
Establece propiedades en un dispositivo de software.
Sintaxis
HRESULT SwDevicePropertySet(
[in] HSWDEVICE hSwDevice,
[in] ULONG cPropertyCount,
[in] const DEVPROPERTY *pProperties
);
Parámetros
[in] hSwDevice
El controlador HSWDEVICE para el dispositivo de software para el que se establecen las propiedades.
[in] cPropertyCount
Número de estructuras DEVPROPERTY en la matriz pProperties .
[in] pProperties
Matriz de estructuras DEVPROPERTY que contienen las propiedades que se van a establecer.
Valor devuelto
S_OK se devuelve si SwDevicePropertySet establece correctamente las propiedades; de lo contrario, un valor de error adecuado.
Comentarios
Puede llamar a SwDevicePropertySet solo después de que el sistema operativo haya llamado a la función de devolución de llamada de la aplicación cliente SW_DEVICE_CREATE_CALLBACK para notificar a la aplicación cliente que se completó la enumeración de dispositivos.
Hay una diferencia sutil entre las propiedades que se establecen como parte de una llamada SwDeviceCreate y las propiedades que se establecen más adelante llamando a SwDevicePropertySet. Las propiedades que se establecen como parte de SwDeviceCreate se almacenan en memoria; Si el dispositivo se desinstala o un controlador NULL borra los almacenes de propiedades, esta propiedad se vuelve a escribir mediante la característica API de dispositivo de software cuando PnP vuelve a enumerar los dispositivos. Esto es todo transparente para el cliente. Las propiedades que se establecen mediante SwDevicePropertySet después de la enumeración no se conservan en la memoria. Sin embargo, si establece una propiedad mediante SwDeviceCreate, puede actualizar el valor con SwDevicePropertySet y esta actualización se aplica al valor en memoria, así como al almacén persistente.
Puede usar SwDevicePropertySet solo para establecer propiedades en el almacén del sistema operativo para el dispositivo.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 8 |
Servidor mínimo compatible | Windows Server 2012 |
Plataforma de destino | Universal |
Encabezado | swdevice.h |
Library | Swdevice.lib; OneCoreUAP.lib en Windows 10 |
Archivo DLL | Cfgmgr32.dll |