Funzione WdfDeviceSetDeviceInterfaceStateEx (wdfdevice.h)

Articolo
02/07/2025

Il metodo WdfDeviceSetDeviceInterfaceStateEx abilita o disabilita un'interfaccia del dispositivo per un dispositivo specificato.

Sintassi

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

Parametri

Device

Handle per un oggetto dispositivo framework.

InterfaceClassGUID

Puntatore a un GUID che identifica la classe dell'interfaccia del dispositivo.

ReferenceString

Puntatore a una struttura UNICODE_STRING che descrive una stringa di riferimento per l'interfaccia del dispositivo. Questo parametro è facoltativo e può essere NULL.

IsInterfaceEnabled

Valore booleano che, se TRUE, abilita l'istanza dell'interfaccia del dispositivo specificata o, se FALSE, la disabilita.

Valore restituito

Nessuno

Osservazioni

Il driver può chiamare questa funzione prima o dopo l'avvio del dispositivo.

Quando viene chiamato prima dell'avvio del dispositivo ,ad esempio da evtDriverDeviceAdd, EvtChildListCreateDeviceo EvtDevicePrepareHardware), il driver deve impostare IsInterfaceEnabled su FALSE per impedire l'abilitazione automatica dell'interfaccia durante l'avvio di PnP. L'impostazione del parametro su TRUE prima dell'avvio del dispositivo è ridondante e tale chiamata deve essere rimossa.

Quando si chiama dopo l'avvio del dispositivo, il comportamento è uguale a WdfDeviceSetDeviceInterfaceState.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 2004
versione minima di KMDF	1.31
versione minima di UMDF	1.31
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL

Vedere anche

WdfDeviceSetDeviceInterfaceState

l'abilitazione e la disabilitazione di un'interfaccia dispositivo

Condividi tramite