Funzione WdfDeviceInitSetCharacteristics (wdfdevice.h)

Articolo
02/27/2024

[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 Il membro Caratteristiche 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 nella funzione EvtDriverDeviceAdd callback prima di chiamare WdfDeviceCreate. Se il driver non riesce a determinare le caratteristiche di un dispositivo fino a quando la funzione EvtDriverDeviceAdd callback restituisce, chiamare WdfDeviceSetCharacteristics.

Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo Framework.

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.

Esempio

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

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (vedere Framework Library Versioning).
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Vedi anche

WdfDeviceSetCharacteristics

Condividi tramite