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

  • Статья

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

Структура WDF_DEVICE_PNP_CAPABILITIES описывает возможности Plug and Play устройства.

Синтаксис

typedef struct _WDF_DEVICE_PNP_CAPABILITIES {
  ULONG         Size;
  WDF_TRI_STATE LockSupported;
  WDF_TRI_STATE EjectSupported;
  WDF_TRI_STATE Removable;
  WDF_TRI_STATE DockDevice;
  WDF_TRI_STATE UniqueID;
  WDF_TRI_STATE SilentInstall;
  WDF_TRI_STATE SurpriseRemovalOK;
  WDF_TRI_STATE HardwareDisabled;
  WDF_TRI_STATE NoDisplayInUI;
  ULONG         Address;
  ULONG         UINumber;
} WDF_DEVICE_PNP_CAPABILITIES, *PWDF_DEVICE_PNP_CAPABILITIES;

Члены

Size

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

LockSupported

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

EjectSupported

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

Removable

Значение типа WDF_TRI_STATE, указывающее , если задано значение WdfTrue, что устройство можно удалить во время работы системы. Если для параметра Removable задано значение WdfTrue , а для Параметра SurpriseRemovalOK — WdfFalse, пользователи должны использовать системную программу отключения или извлечения оборудования.

DockDevice

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

UniqueID

WDF_TRI_STATE типизированное значение, указывающее, если задано значение WdfTrue, идентификатор экземпляра устройства уникален для всей системы. Если параметр UniqueID имеет значение WdfFalse, идентификатор экземпляра уникален только для шины устройства. Дополнительные сведения об идентификаторах экземпляров см. в разделе Строки идентификации устройств.

SilentInstall

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

SurpriseRemovalOK

WDF_TRI_STATE типизированное значение, указывающее, что, если задано значение WdfTrue (а для параметра Removable также задано значение WdfTrue), пользователи могут удалить устройство без использования программы отключения или извлечения оборудования системы.

HardwareDisabled

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

NoDisplayInUI

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

Address

Адрес, указывающий, где находится устройство в шине.

Интерпретация этого числа зависит от шины. Если адрес неизвестен или водитель автобуса не поддерживает адрес, водитель автобуса оставляет элемент Address со значением по умолчанию 0xFFFFFFFF (-1).

В следующем списке описаны сведения, которые некоторые водители автобуса хранят в элементе Address для своих дочерних устройств.

Шина Описание
1394 Не предоставляет адрес, так как адреса являются непостоянными. Значение по умолчанию — 0xFFFFFFFF.
EISA Номер слота (0–F).
IDE Для устройства интегрированной среды разработки адрес содержит целевой идентификатор и LUN. Для канала интегрированной среды разработки адрес равен нулю или одному (0 = основной канал и 1 = дополнительный канал).
ISApnp Не предоставляет адрес. Значение по умолчанию — 0xFFFFFFFF.
PC Card (PCMCIA) Номер сокета (обычно 0x00 или 0x40).
PCI Номер устройства в высоком слове и номер функции в нижнем слове.
SCSI Идентификатор целевого объекта.
USB номер порта.

UINumber

Число, связанное с устройством и отображаемое в пользовательских интерфейсах. Обычно это номер слота, воспринимаемый пользователем, например номер, напечатанный рядом с слотом на доске, или другой номер, который помогает пользователю найти устройство. Если параметр UINumber неизвестен или если указание номера не поможет пользователю определить расположение устройства, драйвер устанавливает для этого значения значение -1.

Комментарии

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

Структура WDF_DEVICE_PNP_CAPABILITIES используется в качестве входных данных для WdfDeviceSetPnpCapabilities.

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

Требования

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

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

WdfDeviceSetPowerCapabilities

WdfPdoInitAssignRawDevice