WdfDeviceSetCharacteristics-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfDeviceSetCharacteristics-Methode legt Gerätemerkmale für ein angegebenes Gerät fest.
Syntax
void WdfDeviceSetCharacteristics(
[in] WDFDEVICE Device,
[in] ULONG DeviceCharacteristics
);
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
[in] DeviceCharacteristics
Ein Wert, der aus systemdefinierten ORed-Konstanten besteht, die Geräteeigenschaften darstellen. Weitere Informationen finden Sie im Element Merkmale der DEVICE_OBJECT-Struktur .
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Sie sollten Geräteeigenschaften festlegen, indem Sie die WdfDeviceInitSetCharacteristics-Methode in Ihrer EvtDriverDeviceAdd-Rückruffunktion aufrufen, bevor Sie WdfDeviceCreate aufrufen. Wenn Ihr Treiber die Merkmale eines Geräts erst ermitteln kann, nachdem die Rückruffunktion EvtDriverDeviceAdd zurückgegeben wurde, sollte der Treiber in der Regel WdfDeviceSetCharacteristics in seiner EvtDevicePrepareHardware-Rückruffunktion aufrufen.
Jeder Aufruf von WdfDeviceSetCharacteristics überschreibt die Einstellungen eines vorherigen Aufrufs.
Beispiele
Im folgenden Codebeispiel wird das FILE_REMOVABLE_MEDIA Merkmal für ein angegebenes Gerät festgelegt.
WdfDeviceSetCharacteristics(
Device,
FILE_REMOVABLE_MEDIA
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |