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

  • Статья

[Относится к KMDF и UMDF]

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

Синтаксис

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

Параметры

[in] Device

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

[in] DeviceState

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

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

None

Remarks

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

Когда драйвер вызывает 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 (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также раздел

WDF_DEVICE_STATE_INIT