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)

Weitere Informationen

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics