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) |