Функция WdfDeviceSetDeviceState (wdfdevice.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Метод WdfDeviceSetDeviceState задает состояние устройства для указанного устройства.

Синтаксис

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

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] DeviceState

Указатель на выделенную драйвером структуру WDF_DEVICE_STATE, содержащую сведения о состоянии устройства.

Возвращаемое значение

Никакой

Замечания

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Когда драйвер вызывает WdfDeviceSetDeviceState, платформа уведомляет диспетчер Plug and Play (PnP), что состояние устройства изменилось.

Примеры

В следующем примере кода диспетчер PnP сообщает, что указанное устройство отключено.

WDF_DEVICE_STATE    deviceState;

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfdevice.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WDF_DEVICE_STATE_INIT

Поделиться через