Función WdfDeviceSetDeviceInterfaceState (wdfdevice.h)

[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