Función WdfDeviceSetDeviceInterfaceState (wdfdevice.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfDeviceSetDeviceInterfaceState habilita o deshabilita una interfaz de dispositivo para un dispositivo especificado.

Nota

El controlador solo debe llamar a esta función después de que se haya iniciado el dispositivo. Para cambiar el estado de la interfaz del dispositivo, llame a WdfDeviceSetDeviceInterfaceStateEx en su lugar.

Sintaxis

void WdfDeviceSetDeviceInterfaceState(
  [in]           WDFDEVICE        Device,
  [in]           const GUID       *InterfaceClassGUID,
  [in, optional] PCUNICODE_STRING ReferenceString,
  [in]           BOOLEAN          IsInterfaceEnabled
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] InterfaceClassGUID

Puntero a un GUID que identifica la clase de interfaz de dispositivo.

[in, optional] ReferenceString

Puntero a una estructura UNICODE_STRING que describe una cadena de referencia para la interfaz del dispositivo. Este parámetro es opcional y puede ser NULL.

[in] IsInterfaceEnabled

Valor booleano que, si es TRUE, habilita la instancia de interfaz de dispositivo especificada o, si es FALSE, la deshabilita.

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Para obtener más información sobre las interfaces de dispositivo y el método WdfDeviceSetDeviceInterfaceState , consulte Uso de interfaces de dispositivo.

Ejemplos

En el ejemplo de código siguiente se deshabilita la interfaz de puerto COM de un controlador.

WdfDeviceSetDeviceInterfaceState (
                                  Device,
                                  (LPGUID) &GUID_DEVINTERFACE_COMPORT,
                                  NULL,
                                  FALSE
                                  );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfdevice.h (incluir Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx