структура WDF_DEVICE_STATE (wdfdevice.h)

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

Структура WDF_DEVICE_STATE указывает состояние Plug and Play устройства.

Синтаксис

typedef struct _WDF_DEVICE_STATE {
  ULONG         Size;
  WDF_TRI_STATE Disabled;
  WDF_TRI_STATE DontDisplayInUI;
  WDF_TRI_STATE Failed;
  WDF_TRI_STATE NotDisableable;
  WDF_TRI_STATE Removed;
  WDF_TRI_STATE ResourcesChanged;
  WDF_TRI_STATE AssignedToGuest;
} WDF_DEVICE_STATE, *PWDF_DEVICE_STATE;

Члены

Size

Размер данной структуры (в байтах).

Disabled

Значение типа WDF_TRI_STATE, которое, если задано значение WdfTrue, указывает, что устройство отключено. Дополнительные сведения о типе WDF_TRI_STATE см. в следующем разделе Примечания.

DontDisplayInUI

Значение типа WDF_TRI_STATE, которое, если задано значение WdfTrue, указывает, что устройство скрыто (не отображается) в диспетчер устройств. Дополнительные сведения см. в разделе Просмотр скрытых устройств. (После установки для этого элемента значения WdfTrue изменение его значения не оказывает никакого влияния.)

Failed

WDF_TRI_STATE типизированное значение, которое, если задано значение WdfTrue, указывает, что устройство присутствует, но завершилось сбоем.

NotDisableable

WDF_TRI_STATE типизированное значение, которое, если задано значение WdfTrue, указывает, что устройство нельзя отключить.

Removed

WDF_TRI_STATE типизированное значение, которое, если задано значение WdfTrue, указывает, что устройство было удалено.

ResourcesChanged

WDF_TRI_STATE типизированное значение, которое, если задано значение WdfTrue, указывает, что требования к ресурсам устройства изменились.

AssignedToGuest

Значение типа WDF_TRI_STATE, которое, если задано значение WdfTrue, указывает, что устройство сообщает о себе как назначенном гостевой секции.

Комментарии

Члены структуры используют тип WDF_TRI_STATE . Значение WdfUseDefault указывает, что платформа будет использовать значение, предоставленное более низким драйвером в стеке. Например, если драйвер шины указывает WdfTrue для NotDisableable , а драйвер функции устройства указывает WdfUseDefault, платформа использует WdfTrue для состояния устройства.

Структура WDF_DEVICE_STATE используется в качестве параметра для WdfDeviceSetDeviceState и WdfDeviceGetDeviceState.

Чтобы инициализировать структуру WDF_DEVICE_STATE , драйвер должен вызвать WDF_DEVICE_STATE_INIT.

Дополнительные сведения об элементах структуры WDF_DEVICE_STATE см. в разделе PNP_DEVICE_STATE.

Требования

Требование	Значение
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfdevice.h (включая Wdf.h)