Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
[Применимо к 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) |