Функция 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. К дополнительным возвращаемым значениям относятся:

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

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

Комментарии

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

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

Требования

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

WdfDeviceAssignInterfaceProperty