структура 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.

Требования