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