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

Статья
02/07/2025

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

Метод WdfDeviceAssignProperty изменяет текущий параметр свойства устройства.

Синтаксис

NTSTATUS WdfDeviceAssignProperty(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           DEVPROPTYPE               Type,
  [in]           ULONG                     Size,
  [in, optional] PVOID                     Data
);

Параметры

[in] Device

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

[in] DeviceProperty

Указатель на структуру WDF_DEVICE_PROPERTY_DATA, которая определяет свойство устройства для изменения.

[in] Type

Переменная DEVPROPTYPEтипа, указывающая тип данных, хранящихся в data.

[in] Size

Размер буфера в байтах, на который указывает Data.

[in, optional] Data

Указатель на выделенный вызывающим буфером, содержащий данные свойства устройства. Задайте для этого параметра значение null, чтобы удалить указанное свойство.

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

Если операция выполнена успешно, WdfDeviceAssignProperty возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER	Один из параметров является неверным.

Метод может возвращать другие значения NTSTATUS.

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

Замечания

Вы можете использовать WdfDeviceAssignProperty для изменения параметра любого свойства, доступного через модель унифицированных свойств.

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.13
минимальная версия UMDF	2.0
заголовка	wdfdevice.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	APC_LEVEL

См. также

WdfDeviceAssignInterfaceProperty

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