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 l'Caratteristiche membro 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 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, il driver in genere deve chiamare WdfDeviceSetCharacteristics nella relativa EvtDevicePrepareHardware funzione di callback.
Ogni chiamata a WdfDeviceSetCharacteristics sovrascrive le impostazioni di qualsiasi chiamata precedente.
Esempi
Nell'esempio di codice seguente viene impostata la caratteristica FILE_REMOVABLE_MEDIA per un dispositivo specificato.
WdfDeviceSetCharacteristics(
Device,
FILE_REMOVABLE_MEDIA
);
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 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |