Функция WdfDeviceSetPnpCapabilities (wdfdevice.h)

Статья
02/07/2025

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

Метод WdfDeviceSetPnpCapabilities сообщает возможности устройства Plug and Play.

Синтаксис

void WdfDeviceSetPnpCapabilities(
  [in] WDFDEVICE                    Device,
  [in] PWDF_DEVICE_PNP_CAPABILITIES PnpCapabilities
);

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] PnpCapabilities

Указатель на структуру, выделенную драйвером WDF_DEVICE_PNP_CAPABILITIES.

Возвращаемое значение

Никакой

Замечания

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Драйвер обычно вызывает WdfDeviceSetPnpCapabilities из одной из следующих функций обратного вызова:

EvtDriverDeviceAdd
EvtDevicePrepareHardware
EvtDeviceD0Entry (если значение параметра PreviousState равно WdfPowerDeviceD3Final)
EvtDeviceSelfManagedIoInit
EvtChildListCreateDevice

Если несколько драйверов в вызове стека драйверов устройства WdfDeviceSetPnpCapabilities, диспетчер Plug and Play использует значения, предоставляемые драйвером, который является самым высоким в стеке.

Примеры

В следующих примерах кода инициализируется структура WDF_DEVICE_PNP_CAPABILITIES, а затем вызывается WdfDeviceSetPnpCapabilities.

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

WDF_DEVICE_PNP_CAPABILITIES_INIT(&pnpCaps);
pnpCaps.SurpriseRemovalOK = WdfTrue;

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия 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)

См. также

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities

Поделиться через