ioSetDevicePropertyData 函数 (wdm.h)

  • 项目

IoSetDevicePropertyData 例程修改设备属性的当前设置。

语法

NTSTATUS IoSetDevicePropertyData(
  [in]           PDEVICE_OBJECT   Pdo,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           LCID             Lcid,
  [in]           ULONG            Flags,
  [in]           DEVPROPTYPE      Type,
  [in]           ULONG            Size,
  [in, optional] PVOID            Data
);

参数

[in] Pdo

指向正在查询的设备 (PDO) 的物理设备对象的指针。

[in] PropertyKey

指向指定设备属性键的 DEVPROPKEY 结构的指针。

[in] Lcid

区域设置标识符。 将此参数设置为特定于语言的 LCID 值或 LOCALE_NEUTRAL。

LOCALE_NEUTRAL LCID 指定 属性是非特定语言 (，不特定于任何语言) 。

不要将此参数设置为 LOCALE_SYSTEM_DEFAULT 或 LOCALE_USER_DEFAULT。

有关特定于语言的 LCID 值的详细信息，请参阅 LCID 结构。

[in] Flags

如果此例程设置的属性值应在计算机重启后保留，请将此参数设置为 PLUGPLAY_PROPERTY_PERSISTENT 。 否则，请将 Flags 设置为零。

Windows 8和Windows Server 2012及更高版本的操作系统将标志视为始终传递PLUGPLAY_PROPERTY_PERSISTENT。

[in] Type

一个 DEVPROPTYPE 值，该值指定数据缓冲区中提供的 数据类型 。

[in] Size

Data 指向的缓冲区的大小（以字节为单位）。

[in, optional] Data

指向设备属性数据的指针。 将此参数设置为 NULL 可删除指定的属性。 如果 Data 为非 NULL，则例程存储属性值的内部副本。 在调用返回后， Data 指向的缓冲区不需要保持有效。

返回值

如果调用成功，IoSetDevicePropertyData 将返回STATUS_SUCCESS，或者在失败时返回相应的 NTSTATUS 代码。

注解

若要查看此例程可用的属性类型，请参阅 的DEVPROP_TYPE_BYTE 和相邻页 DEVPROP_TYPE_*。

内核模式驱动程序使用 IoSetDevicePropertyData 例程来修改定义为统一设备属性模型的一部分的设备属性。 有关设备属性的详细信息，请参阅 设备属性。

若要删除特定区域设置的属性，请在 Lcid 中传递特定于语言的 LCID 值，在数据中传递 NULL。

若要删除所有区域设置的属性，请在 Lcid 中传递LOCALE_NEUTRAL，在 Data 中传递 NULL。

若要修改特定区域设置的属性，请在 Lcid 中传递特定于语言的 LCID 值，在 Data 中传递非 NULL 值。

若要修改所有区域设置的属性，请在 Lcid 中传递LOCALE_NEUTRAL，在 Data 中传递非 NULL。

从 Windows 8 开始，Windows Server 2012 Lcid 中的传递LOCALE_NEUTRAL将被视为其他任何区域设置。

驱动程序可以使用 IoGetDevicePropertyData 例程来获取设备属性的当前值。

IoSetDeviceProperty 的调用方必须在系统线程上下文中的 IRQL <= APC_LEVEL 运行。

要求

要求 值
最低受支持的客户端 从 Windows Vista 开始可用。
目标平台 通用
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI (storport) ， PowerIrpDDis (wdm)

另请参阅

DEVPROPKEY

DEVPROPTYPE

IoGetDevicePropertyData