Funzione WdfDeviceSetDeviceInterfaceStateEx (wdfdevice.h)

Articolo
02/27/2024

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, EvtChildListCreateDevice o 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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 2004
Versione KMDF minima	1.31
Versione UMDF minima	1.31
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL

Vedi anche

WdfDeviceSetDeviceInterfaceState

Abilitazione e disabilitazione di un'interfaccia dispositivo