Funzione WdfDeviceSetDeviceInterfaceState (wdfdevice.h)

2025-02-07

[Si applica a KMDF e UMDF]

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

Nota

Il driver deve chiamare questa funzione solo dopo l'avvio del dispositivo. Per modificare lo stato dell'interfaccia dall'aggiunta del dispositivo, chiamare WdfDeviceSetDeviceInterfaceStateEx.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] InterfaceClassGUID

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

[in, optional] 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.

[in] IsInterfaceEnabled

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

Valore restituito

Nessuno

Osservazioni

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Per altre informazioni sulle interfacce del dispositivo e sul metodo WdfDeviceSetDeviceInterfaceState, vedere Using Device Interfaces.

Esempi

Nell'esempio di codice seguente viene disabilitata l'interfaccia della porta COM di un driver.

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

UNICODE_STRING

WdfDeviceCreateDeviceInterface WdfDeviceSetDeviceInterfaceStateEx