WdfDeviceSetCharacteristics-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfDeviceSetCharacteristics- Methode legt die Gerätemerkmale für ein angegebenes Gerät fest.
Syntax
void WdfDeviceSetCharacteristics(
[in] WDFDEVICE Device,
[in] ULONG DeviceCharacteristics
);
Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
[in] DeviceCharacteristics
Ein Wert, der aus vom System definierten ORed-Konstanten besteht, die Gerätemerkmale darstellen. Weitere Informationen finden Sie im Merkmale Member der DEVICE_OBJECT Struktur.
Rückgabewert
Nichts
Bemerkungen
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Sie sollten gerätemerkmale festlegen, indem Sie die WdfDeviceInitSetCharacteristics--Methode in Ihrer EvtDriverDeviceAdd- Rückruffunktion aufrufen, bevor Sie WdfDeviceCreateaufrufen. Wenn Ihr Treiber die Merkmale eines Geräts erst ermitteln kann, nachdem die EvtDriverDeviceAdd Rückruffunktion 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- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfdevice.h (einschließen Wdf.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |