WdfDeviceSetDeviceState-Funktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WdfDeviceSetDeviceState-Methode legt den Gerätestatus für ein angegebenes Gerät fest.
Syntax
void WdfDeviceSetDeviceState(
[in] WDFDEVICE Device,
[in] PWDF_DEVICE_STATE DeviceState
);
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
[in] DeviceState
Ein Zeiger auf eine vom Treiber zugewiesene WDF_DEVICE_STATE Struktur, die die Zustandsinformationen des Geräts enthält.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Wenn ein Treiber WdfDeviceSetDeviceState aufruft, benachrichtigt das Framework den Plug & Play-Manager (PnP), dass sich der Gerätestatus geändert hat.
Beispiele
Im folgenden Codebeispiel wird der PnP-Manager darüber informiert, dass ein angegebenes Gerät deaktiviert ist.
WDF_DEVICE_STATE deviceState;
WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
Device,
&deviceState
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |