Funzione WdfDeviceSetCharacteristics (wdfdevice.h)

[Si applica solo a KMDF]

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

Sintassi

void WdfDeviceSetCharacteristics(
  [in] WDFDEVICE Device,
  [in] ULONG     DeviceCharacteristics
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[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 .

Valore restituito

nessuno

Osservazioni

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

È necessario impostare le caratteristiche del dispositivo chiamando il metodo WdfDeviceInitSetCharacteristics nella funzione di callback EvtDriverDeviceAdd prima di chiamare WdfDeviceCreate. Se il driver non riesce a determinare le caratteristiche di un dispositivo finché non viene restituita la funzione di callback EvtDriverDeviceAdd , il driver in genere deve chiamare WdfDeviceSetCharacteristics nella relativa funzione di callback EvtDevicePrepareHardware .

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

Esempio

Nell'esempio di codice seguente viene impostata la caratteristica FILE_REMOVABLE_MEDIA per un dispositivo specificato.

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	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	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics