Compartir a través de


Función WdfDeviceSetDeviceInterfaceStateEx (wdfdevice.h)

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

Sintaxis

void WdfDeviceSetDeviceInterfaceStateEx(
  WDFDEVICE        Device,
  const GUID       *InterfaceClassGUID,
  PCUNICODE_STRING ReferenceString,
  BOOLEAN          IsInterfaceEnabled
);

Parámetros

Device

Identificador de un objeto de dispositivo de marco.

InterfaceClassGUID

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

ReferenceString

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

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

El controlador puede llamar a esta función antes o después de que se haya iniciado el dispositivo.

Cuando se llama antes de que se inicie el dispositivo (por ejemplo, desde EvtDriverDeviceAdd, EvtChildListCreateDevice o EvtDevicePrepareHardware), el controlador debe establecer IsInterfaceEnabled en FALSE para evitar que la interfaz se habilite automáticamente durante el inicio de PnP. Establecer el parámetro en TRUE antes de que el dispositivo se inicie sea redundante y se debe quitar dicha llamada.

Al llamar después de iniciar el dispositivo, el comportamiento es el mismo que WdfDeviceSetDeviceInterfaceState.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 2004
Versión mínima de KMDF 1,31
Versión mínima de UMDF 1,31
Encabezado wdfdevice.h (incluya Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL

Consulte también

WdfDeviceSetDeviceInterfaceState

Habilitación y deshabilitación de una interfaz de dispositivo