Funzione WdfDeviceInitSetCharacteristics (wdfdevice.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il metodo WdfDeviceInitSetCharacteristics imposta le caratteristiche del dispositivo per un dispositivo specificato.

Sintassi

void WdfDeviceInitSetCharacteristics(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] ULONG           DeviceCharacteristics,
  [in] BOOLEAN         OrInValues
);

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT.

[in] DeviceCharacteristics

Valore costituito da costanti definite dal sistema ORed che rappresentano le caratteristiche del dispositivo. Per altre informazioni, vedere l'Caratteristiche membro della struttura DEVICE_OBJECT.

[in] OrInValues

Valore booleano. Se questo valore è TRUE, il valore DeviceCharacteristics è ORed con caratteristiche del dispositivo esistenti. Se il valore è FALSE, il valore DeviceCharacteristics sostituisce le caratteristiche del dispositivo esistenti.

Valore restituito

Nessuno

Osservazioni

Per impostare le caratteristiche del dispositivo, chiamare il metodo WdfDeviceInitSetCharacteristics nel EvtDriverDeviceAdd funzione di callback prima di chiamare WdfDeviceCreate. Se il driver non riesce a determinare le caratteristiche di un dispositivo fino a quando non viene restituita la funzione di callback EvtDriverDeviceAdd, chiamare WdfDeviceSetCharacteristics.

Per altre informazioni sulla chiamata di WdfDeviceCreate, vedere Creating a Framework Device Object.

Il framework imposta sempre la caratteristica FILE_DEVICE_SECURE_OPEN, quindi il driver non deve impostare questa caratteristica.

Ogni chiamata a WdfDeviceInitSetCharacteristics sovrascrive le impostazioni di qualsiasi chiamata precedente.

Esempi

L'esempio di codice seguente indica che un dispositivo è un disco floppy.

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Vedere anche

WdfDeviceSetCharacteristics

Condividi tramite