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

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

  • Статья

[Относится к 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 (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL APC_LEVEL

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

WdfDeviceAssignInterfaceProperty