WdfDeviceSetDeviceState-Funktion (wdfdevice.h)

Artikel
02/07/2025

[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 zu einem Framework-Geräteobjekt.

[in] DeviceState

Ein Zeiger auf eine vom Treiber zugewiesene WDF_DEVICE_STATE Struktur, die die Statusinformationen des Geräts enthält.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Wenn ein Treiber WdfDeviceSetDeviceStateaufruft, benachrichtigt das Framework den Plug and Play(PnP)-Manager, 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-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WDF_DEVICE_STATE_INIT

Freigeben über