Compartir a través de


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