Funzione WdfDeviceSetInterfaceState (wdfdevice.h)

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceSetInterfaceState abilita o disabilita un'interfaccia 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 invece 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

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Per altre informazioni sulle interfacce del dispositivo e sul metodo WdfDeviceSetDeviceInterfaceState , vedere Uso di interfacce dispositivo.

Esempio

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

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx