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

Статья
08/08/2023

[Применяется только к KMDF]

Метод WdfDeviceSetCharacteristics задает характеристики устройства для указанного устройства.

Синтаксис

void WdfDeviceSetCharacteristics(
  [in] WDFDEVICE Device,
  [in] ULONG     DeviceCharacteristics
);

Параметры

[in] Device

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

[in] DeviceCharacteristics

Значение типа , состоящее из системных констант ORed, которые представляют характеристики устройства. Дополнительные сведения см. в разделе Характеристики структуры DEVICE_OBJECT .

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

None

Remarks

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

Необходимо задать характеристики устройства, вызвав метод WdfDeviceInitSetCharacteristics в функции обратного вызова EvtDriverDeviceAdd перед вызовом WdfDeviceCreate. Если драйвер не может определить характеристики устройства до тех пор, пока не будет возвращена функция обратного вызова EvtDriverDeviceAdd , драйвер обычно должен вызывать WdfDeviceSetCharacteristics в функции обратного вызова EvtDevicePrepareHardware .

Каждый вызов WdfDeviceSetCharacteristics перезаписывает параметры любого предыдущего вызова.

Примеры

В следующем примере кода задается FILE_REMOVABLE_MEDIA характеристика для указанного устройства.

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Верхняя часть	wdfdevice.h (включая Wdf.h)
Библиотека	Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL	<=DISPATCH_LEVEL
Правила соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics