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

Статья
02/07/2025

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

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

Синтаксис

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

Параметры

[in] Device

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

[in] DeviceCharacteristics

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

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

Никакой

Замечания

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

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

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

Примеры

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

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
заголовка	wdfdevice.h (include Wdf.h)
библиотеки	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics

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