WdfDeviceSetDeviceState function (wdfdevice.h)

Artikel
02/22/2024

[Applies to KMDF and UMDF]

The WdfDeviceSetDeviceState method sets the device state for a specified device.

Syntax

void WdfDeviceSetDeviceState(
  [in] WDFDEVICE         Device,
  [in] PWDF_DEVICE_STATE DeviceState
);

Parameters

[in] Device

A handle to a framework device object.

[in] DeviceState

A pointer to a driver-allocated WDF_DEVICE_STATE structure that contains the device's state information.

Return value

None

Remarks

A bug check occurs if the driver supplies an invalid object handle.

When a driver calls WdfDeviceSetDeviceState, the framework notifies the Plug and Play (PnP) manager that the device state has changed.

Examples

The following code example informs the PnP manager that a specified device is disabled.

WDF_DEVICE_STATE    deviceState;

WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
                         Device,
                         &deviceState
                         );

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.0
Minimum UMDF version	2.0
Header	wdfdevice.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Delen via