Функция WdfDeviceSetPnpCapabilities (wdfdevice.h)
[Применимо к 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 .
Возвращаемое значение
None
Remarks
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Драйвер обычно вызывает WdfDeviceSetPnpCapabilities из одной из следующих функций обратного вызова:
-
EvtDeviceD0Entry (если параметр PreviousState имеет значение WdfPowerDeviceD3Final)
Примеры
В следующих примерах кода инициализируется структура 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 (включая Wdf.h) |
Библиотека | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |