Compartir a través de

Función SwDeviceInterfacePropertySet (swdevice.h)

  • Artículo

Establece las propiedades en una interfaz de dispositivo de software.

Sintaxis

HRESULT SwDeviceInterfacePropertySet(
  [in] HSWDEVICE         hSwDevice,
  [in] PCWSTR            pszDeviceInterfaceId,
  [in] ULONG             cPropertyCount,
  [in] const DEVPROPERTY *pProperties
);

Parámetros

[in] hSwDevice

El controlador HSWDEVICE para el dispositivo de software de la interfaz para el que se van a establecer las propiedades.

[in] pszDeviceInterfaceId

Cadena que identifica la interfaz en la que se van a establecer 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 en la interfaz.

Valor devuelto

S_OK se devuelve si SwDeviceInterfacePropertySet estableció correctamente las propiedades en la interfaz; de lo contrario, un valor de error adecuado.

Comentarios

Puedes llamar a SwDeviceInterfacePropertySet 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 SwDeviceInterfaceRegister y las propiedades que se establecen más adelante llamando a SwDeviceInterfacePropertySet. Las propiedades que se establecen como parte de SwDeviceInterfaceRegister se almacenan en la memoria; Si el dispositivo se desinstala o un controlador nulo borra los almacenes de propiedades, la característica API de dispositivo de software vuelve a escribir estas propiedades cuando PnP vuelve a enumerar los dispositivos. Todo esto es transparente para el cliente. Las propiedades que se establecen mediante SwDeviceInterfacePropertySet después de la enumeración no se conservan en la memoria. Sin embargo, si establece una propiedad mediante SwDeviceInterfaceRegister, puede actualizar el valor con SwDeviceInterfacePropertySet y esta actualización se aplica al valor en memoria, así como al almacén persistente.

Puede usar SwDeviceInterfacePropertySet solo para establecer propiedades en el almacén del sistema operativo para la interfaz.

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