Compartir a través de

Función SwDeviceInterfaceSetState (swdevice.h)

  • Artículo

Habilita o deshabilita una interfaz de dispositivo para un dispositivo de software.

Sintaxis

HRESULT SwDeviceInterfaceSetState(
  [in] HSWDEVICE hSwDevice,
  [in] PCWSTR    pszDeviceInterfaceId,
  [in] BOOL      fEnabled
);

Parámetros

[in] hSwDevice

El controlador HSWDEVICE para el dispositivo de software para el que registrar una interfaz de dispositivo.

[in] pszDeviceInterfaceId

Cadena que identifica la interfaz para habilitar o deshabilitar.

[in] fEnabled

Valor booleano que indica si se va a habilitar o deshabilitar la interfaz. TRUE para habilitar; FALSE para deshabilitar.

Valor devuelto

S_OK se devuelve si SwDeviceInterfaceSetState habilitó o deshabilitó correctamente la interfaz; de lo contrario, un valor de error adecuado.

Comentarios

Puede llamar a SwDeviceInterfaceSetState 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.

Solo puede usar SwDeviceInterfaceSetState para administrar interfaces registradas anteriormente con SwDeviceInterfaceRegister en el dispositivo de software que hSwDevice representa.

Las aplicaciones cliente usan SwDeviceInterfaceSetState para administrar el estado que quieren que tenga la interfaz. El dispositivo de software cambia el estado real de la interfaz según sea necesario. Por ejemplo, una aplicación cliente deshabilita y vuelve a habilitar la interfaz si el dispositivo se vuelve a enumerar por cualquier motivo. El estado siempre intenta reflejar el estado necesario de la aplicación cliente.

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